Класс CCheckListBox

Статья
06/10/2015

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

class CCheckListBox : public CListBox

Члены

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

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

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

Имя	Описание
CCheckListBox::Create	Создает окно контрольного списка Windows и вложение его к объекту CCheckListBox.
CCheckListBox::DrawItem	Вызываемый платформой, когда визуальный аспект списка рисования владельцем изменяется.
CCheckListBox::Enable	Включение или отключение элемент окно контрольного списка.
CCheckListBox::GetCheck	Получает состояние флажка элемента.
CCheckListBox::GetCheckStyle	Возвращает стиль флажков элемента управления.
CCheckListBox::IsEnabled	Указывает, включен ли элемент.
CCheckListBox::MeasureItem	Вызываемый платформой, когда будет создать список с учетом рисования владельцем.
CCheckListBox::OnGetCheckPosition	Вызываемый платформой для получения положения флажка элемента.
CCheckListBox::SetCheck	Устанавливает состояние флажка элемента.
CCheckListBox::SetCheckStyle	Задает стиль флажков элемента управления.

Заметки

"Окно контрольного списка" отображает список элементов, таких как имена файлов. Каждый элемент списка есть флажок рядом с ним, что пользователь может проверять или удалить.

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

Чтобы создать собственное окно контрольного списка, необходимо создать собственный класс, производный от CCheckListBox. Чтобы создать собственный класс, разработайте конструктор для производного класса, а затем вызовите Создать.

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

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

Уведомление (idON_, memberFxn**)**

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

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

afx_msgvoidmemberFxn**( );**

Только одна запись сообщение- сопоставления, относящиеся именно к CCheckListBox (но см. также записи сообщение- сопоставления для CListBox):

ON_CLBN_CHKCHANGE Пользователя изменилось состояние флажка элемента.

Если окно контрольного списка по умолчанию окно контрольного списка (список строк с заданным значением по умолчанию- размер флажками слева от каждого), можно использовать значение по умолчанию CCheckListBox::DrawItem для рисования окно контрольного списка. В противном случае необходимо переопределить функцию CListBox::CompareItem и функции CCheckListBox::DrawItem и CCheckListBox::MeasureItem.

Можно создать окно контрольного списка или из шаблона диалогового окна или непосредственно в коде.