Класс CListBox
Элемент управления List Box "окно списка", называемый иногда просто списком, используется для работы с информацией, отображаемой в виде списка. Окно списка может быть реализовано как список с единичным или с множественным выбором.
Окно списка можно связать как с переменной типа CString, так и с объектом класса CListBox.
Свойство Selection позволяет устанавливать тип списка:
- Single (по умолчанию) - пользователь может выделить только один элемент списка
- Multiple - пользователь может одновременно выделить несколько элементов списка. Выделение элементов (или снятие выделения) осуществляется при щелчке или двойном щелчке мыши.
- Extended - пользователь может одновременно выделить несколько элементов списка. Выделение элементов (или снятие выделения) осуществляется перемещением мыши при нажатой кнопке.
- None - пользователь не может выделить ни одного элемента списка.
Класс CListBox предоставляет широкий набор методов для работы со списком, включая следующие:
- GetCount - метод возвращает количество элементов в окне списка.
- SetTopIndex - метод прокручивает окно списка к указанному элементу, отображая его первым видимым элементом.
Например:
extern CListBox* pmyListBox; // Определение первым видимым элементом списка // элемента,расположенного посередине списка pmyListBox->SetTopIndex(pmyListBox->GetCount()/2);
- GetText- метод возвращает строку по указанному индексу элемента списка.
Например:
extern CListBox* pmyListBox; CString str, str2; int n; for (int i=0;i < pmyListBox->GetCount();i++) { n = pmyListBox->GetTextLen( i ); pmyListBox->GetText( i, str.GetBuffer(n) ); str.ReleaseBuffer(); // Дампинг всех элементов списка (#ifdef _DEBUG ) str2.Format(_T("item %d: %s\r\n"), i, str.GetBuffer(0)); afxDump << str2; }
- SetCurSel- метод выделяет указанный элемент списка и при необходимости прокручивает окно списка так, чтобы выделенный элемент стал видимым.
- GetSelCount - метод возвращает общее количество выделенных элементов в окне списка с множественным выбором.
- AddString - метод добавляет в окно списка новый элемент, содержащий указанную строку.
- DeleteString - метод удаляет из окна списка строку с соответствующим индексом.
- InsertString - метод вставляет в указанное место окна списка новый элемент, содержащий заданную строку.
- FindString - метод выполняет поиск указанной строки в окне списка.
- ResetContent - метод удаляет все элементы окна списка.
