Класс CListCtrl инкапсулирует функциональные возможности элемент "список управления," который отображает коллекцию элементов каждый состоящий из значок (из списка изображений) и метки. В дополнение к значок и метку каждый элемент может иметь информацию, отображаемую в colums справа от значка и label. Этот элемент управления (и, следовательно, класс CListCtrl ) доступны только для программ, работающих под Windows 95 и Windows NT версии 3.51 и выше.
Ниже приводится краткий обзор класса CListCtrl . Подробный, концептуальные, см С использованием CListCtrl и Управления темы в руководство Visual C++ программиста.
Представления
Элементы управления представления списка может отображать их содержимое четырьмя различными способами, под названием «взгляды.»
Каждый элемент отображается в виде полноразмерного значка (32 x 32 пикселей) с лейблом под ним. Пользователь может перетаскивать элементы в любое место в окне представления списка.
Каждый элемент отображается как мелкого значка (16 x 16 точек) с лейблом справа от него. Пользователь может перетаскивать элементы в любое место в окне представления списка.
Каждый элемент отображается в виде небольшого значка с меткой справа от него. Элементы расположены в столбцах и нельзя перетащить в любое место в окне представления списка.
Каждый элемент отображается в отдельной строке с дополнительной информацией, в столбцах справа. Крайний левый столбец содержит небольшой значок и метку, а последующие столбцы содержат подэлементов как указанным приложением. Встроенный заголовок элемента управления (класс CHeaderCtrl) реализует эти столбцы. Для получения дополнительных сведений о управления заголовка и столбцов в представлении отчета, см. с помощью CListCtrl: Добавление столбцов для элемента управления (представление отчета).
Стиль представления текущего списка элемента управления определяет текущее представление. Более подробную информацию о них эти стили и их использования, см. с помощью CListCtrl: изменение стилей элементов управления списка.
Расширенные стили
В дополнение к стандартным список стилей класс CListCtrl поддерживает большой набор расширенных стилей, предоставляя обогащенный функциональность. Некоторые примеры этой функциональности:
Когда включен, позволяет автоматический выбор элемента, когда курсор находится над текстовым полем для определенного периода времени.
Когда включен, позволяет контролировать для поддержки до элементов DWORD . Это возможно, поместив накладных расходов управления элемента данных о применении. За исключением выбора элемента и направленность информации все сведения об элементе должна управляться приложением. Для получения дополнительной информации, смотрите с помощью CListCtrl: виртуальный список элементов управления.
Когда параметр включен, позволяет горячие слежения (автоматическое выделение текста элемента) и one– или two– нажмите кнопку Активация выделенного элемента.
Когда параметр включен, позволяет drag-and-drop изменение порядка столбцов в элементе управления представления списка. Доступно только в режиме отчета.
Информацию об использовании этих новых расширенных стилей, см. с помощью CListCtrl: изменение стилей элементов управления списка.
Элементы и подэлементы
Каждый элемент в элементе управления представления списка состоит из значок (из списка изображений), подпись, текущего состояния и определенное приложением значение (упоминаемый как «данные»). Один или несколько подэлементы также могут быть связаны с каждым элементом. «Подпункта» является строкой, которая в режиме отчета могут быть отображены в столбце справа от элемента значок и метку. Все элементы в элементе управления представления списка должны иметь одинаковое количество подэлементов.
Класс CListCtrl предоставляет несколько функций для вставки, удаления, поиска и изменения этих элементов. Для получения дополнительной информации, см. CListCtrl::GetItem, CListCtrl::InsertItemи CListCtrl::FindItem, с помощью CListCtrl: Добавление элементов в элемент управления, и с помощью CListCtrl:, прокрутки, Организация, сортировка и поиск в списке элементов управления.
По умолчанию элемент управления представления списком отвечает за хранение атрибутов элемента значок и текст. Однако в дополнение к этим типов элементов, класс CListCtrl поддерживает «обратного вызова элементов.» «Элемент ответного вызова» это элемент списка для которого приложение — вместо элемента управления — хранит текст, значок или оба. Маска обратного вызова используется для указания, какие атрибуты элемента (текст или значок) поставляются приложением. Если приложение использует элементы обратного вызова, он должен быть может поставлять текста и значок атрибутов по требованию. Обратного вызова элементы полезны, если ваше приложение уже поддерживает некоторые из этих сведений. Для получения дополнительной информации, смотрите CListCtrl::GetCallBackMask и с помощью CListCtrl: элементы обратного вызова и маска обратного вызова.
Списки изображений
Значки, изображения элемента заголовка и цветам определены государствам для представления списка элементов, содержатся в нескольких изображений списков (осуществляться класса CImageList), которые создать и назначить элементом управления представления списка. Каждый элемент управления view список может иметь до четырех различных типов списков изображений:
Используемые в представлении значков для полного размера значков.
Используется в мелких значков, списка и представления отчетов для меньших версий значков, используемых в представлении значков.
Содержит состояние изображения, которые отображаются рядом с значка элемента для указания состояния, определяемые приложением.
Используемые в представлении отчета для маленьких изображений, которые появляются в каждом элементе управления заголовка.
По умолчанию элемент управления представления списка разрушает списки изображений, возложенные на него, когда он будет уничтожен; Однако это поведение можно настроить, уничтожив каждый список изображений, когда он больше не используется, как определено приложением разработчик. Для получения дополнительной информации, смотрите с помощью CListCtrl: элементы списков и списков изображений и с помощью CListCtrl: элементы списков и списков изображений.
# include lt;afxcmn.h>
Члены класса | Базовый класс | Иерархическая схема
Образцы Образца MFC DAOTABLE | Образца MFC HTTPSVR | Образца MFC LISTHDR | Образца ROWLIST MFC | Образца MFC DBVLIST
См. также CImageList