Класс CListBox

Статья
06/10/2015

Предоставляет функциональность списка Windows.

class CListBox : public CWnd

Члены

Открытые конструкторы

Имя	Описание
CListBox::CListBox	Создает объект CListBox.

Открытые методы

Имя	Описание
CListBox::AddString	Добавляет строку в список.
CListBox::CharToItem	Переопределение для предоставления пользовательской обработки для списков WM_CHAR рисования владельцем, не имеющие строк.
CListBox::CompareItem	Вызываемый средой, чтобы определить положение нового элемента в сортированном списке рисования владельцем.
CListBox::Create	Создает список Windows и вложение его к объекту CListBox.
CListBox::DeleteItem	Вызываемый платформой, когда пользователь удаляет элемент из списка рисования владельцем.
CListBox::DeleteString	Удаляет строку из списка.
CListBox::Dir	Добавляет имена файлов, disk или оба из текущей папки в список.
CListBox::DrawItem	Вызываемый платформой, когда визуальный аспект списка рисования владельцем изменяется.
CListBox::FindString	Ищет строки в списке.
CListBox::FindStringExact	Находит первую строку списка, совпадающий с заданной строкой.
CListBox::GetAnchorIndex	Извлекает нулевой- основан индекс текущего элемента привязки в списке.
CListBox::GetCaretIndex	Определяет индекс элемента, который содержит прямоугольник фокуса в списке, разрешающий несвязный выбор нескольких строк.
CListBox::GetCount	Возвращает число строк в списке.
CListBox::GetCurSel	Возвращает индекс нулевой- на основе выбранной строки в списке.
CListBox::GetHorizontalExtent	Возвращает ширину в пикселях, что список может выполнять горизонтальную прокрутку.
CListBox::GetItemData	Возвращает 32 разрядное значение, связанное с элементом списка.
CListBox::GetItemDataPtr	Возвращает указатель к элементу списка.
CListBox::GetItemHeight	Указывает высоту элементов в списке.
CListBox::GetItemRect	Возвращает ограничивающий прямоугольник элемента списка в данный момент отображается.
CListBox::GetListBoxInfo	Получает число элементов в столбец.
CListBox::GetLocale	Извлекает код языка для списка.
CListBox::GetSel	Возвращает состояние выделения элемента списка.
CListBox::GetSelCount	Возвращает число строк, выбранных в списке, разрешающий несвязный выбор нескольких строк.
CListBox::GetSelItems	Возвращает индексы строк, выделенных в данный момент в списке.
CListBox::GetText	Копирует элемент списка в буфер.
CListBox::GetTextLen	Возвращает длину в байтах для элемента списка.
CListBox::GetTopIndex	Получает индекс первой видимой строки в списке.
CListBox::InitStorage	Preallocates блоки памяти для элементов и строк списка.
CListBox::InsertString	Вставляет строку в конкретное расположение в список.
CListBox::ItemFromPoint	Возвращает индекс элемента списка в наибольшей степени точку.
CListBox::MeasureItem	Вызываемый платформой, если список рисования владельцем будет создать для определения измерения списка.
CListBox::ResetContent	Удаляет все записи из списка.
CListBox::SelectString	Выполняет поиск и выберите строку в простом списке.
CListBox::SelItemRange	Выбирает диапазон строк или deselects в списке, разрешающий несвязный выбор нескольких строк.
CListBox::SetAnchorIndex	Задает привязку в списке, разрешающий несвязный выбор нескольких строк, чтобы начать расширенного выделение.
CListBox::SetCaretIndex	Задает прямоугольник фокуса к элементу по указанному индексу в списке, разрешающий несвязный выбор нескольких строк.
CListBox::SetColumnWidth	Задает ширину столбцов списка, состоящего из нескольких столбцов.
CListBox::SetCurSel	Выбирает строку списка.
CListBox::SetHorizontalExtent	Задает ширину в пикселях, что список может выполнять горизонтальную прокрутку.
CListBox::SetItemData	Устанавливает 32 разрядное значение, связанный с элементом списка.
CListBox::SetItemDataPtr	Задает указатель к элементу списка.
CListBox::SetItemHeight	Задает высоту элементов в списке.
CListBox::SetLocale	Задает код языка для списка.
CListBox::SetSel	Устанавливает или deselects элемент списка в список, разрешающий несвязный выбор нескольких строк.
CListBox::SetTabStops	Устанавливает позицию табуляции в списке.
CListBox::SetTopIndex	Задает нулевой- на основе индекс первой видимой строки в списке.
CListBox::VKeyToItem	Переопределение для предоставления пользовательской обработки WM_KEYDOWN для списков с использованием стиля LBS_WANTKEYBOARDINPUT.

Заметки

Список отображает список элементов, таких как имена файлов, которые пользователь может просматривать и выбирать.

В простом списке, пользователь может выбрать только один элемент. В список, разрешающий несвязный выбор нескольких строк, можно выделить диапазон элементов. Когда пользователь выбирает элемент, его выбрать, и список отправляет сообщение уведомления родительского окна.

Можно создать список или из шаблона диалогового окна или непосредственно в коде. Чтобы создать напрямую, создайте объект CListBox, затем вызовите функцию-член Создание для создания элемента управления списка Windows и вложить его к объекту CListBox. Использовать список в шаблоне диалоговое окно, следует объявить переменную списка в классе диалогового окна, а затем использовать DDX_Control в функции DoDataExchange типа диалогового окна для подключения переменную-член к элементу управления. (это делается автоматически при добавлении переменная элемента управления к классу диалогового окна).

Конструкция может быть одношаговым процессом в классе, производном от CListBox. Создание конструктора производного класса и вызовите Создать из конструктора.

Если нужно обрабатывать сообщения уведомлений Windows, отправленные списком с родительским элементом (обычно класс, производный от CDialog), то добавление функции-члена записи и обработчика сообщений сообщение- сопоставления в родительский класс для каждого сообщения.

Каждая запись сообщение-сопоставления принимает следующую форму:

ON_Notification( id, memberFxn )

где id задает идентификатор дочернего окна управления списка отправляющее уведомление и memberFxn имя родительского функции-члена был написан для обработки уведомления.

Родительский прототип функции следующим образом:

afx_msg void memberFxn( );

Ниже приведен список потенциальных записей сообщение- сопоставления и описание вариантов, в которых они были бы отправлены к родительскому элементу.

ON_LBN_DBLCLK Пользователь дважды щелкает строка в списке. Только список, содержащий стиль LBS_NOTIFY отправляет сообщение уведомления.
ON_LBN_ERRSPACE Список не может выделить достаточно памяти для удовлетворять запросу.
ON_LBN_KILLFOCUS Список теряет фокус ввода.
ON_LBN_SELCANCEL Текущее выделение списка отменено. Это сообщение отправлено только если список имеет стиль LBS_NOTIFY.
ON_LBN_SELCHANGE Выделение в списке изменилось. Это уведомление не отправлено, если выделение изменен функцией-членом CListBox::SetCurSel. Это уведомление применяется только к списку, который содержит стиль LBS_NOTIFY. Сообщение уведомления LBN_SELCHANGE отправлено для списка, разрешающий несвязный выбор нескольких строк при нажатии пользователем клавиши со стрелками, даже если выделение не изменяются.
Список ON_LBN_SETFOCUS получает фокус ввода.
ON_WM_CHARTOITEM Список рисования владельцем, у которого нет строк получает сообщение WM_CHAR.
Список ON_WM_VKEYTOITEM a со стилем LBS_WANTKEYBOARDINPUT получает сообщение WM_KEYDOWN.

При создании объекта CListBox в диалоговое окно (через ресурс диалогового окна), то объект CListBox автоматически уничтожается, когда пользователь закрывает диалоговое окно.

При создании объекта CListBox в окне, можно удалить объект CListBox. При создании объекта CListBox в стеке, он удален автоматически. При создании объекта CListBox в куче с помощью функции новый, необходимо вызвать метод удалить в объекте, чтобы удалить его, когда пользователь закрывает родительское окно.

При выборе любая память в объекте CListBox, следует переопределить CListBox деструктор для удаления распространения.