Класс CListCtrl

Статья
02/20/2013

Инкапсулирует функциональные возможности управления "список"," которое указывает коллекцию элементов каждое, состоящий из значка (из списка образа) и метки.

class CListCtrl : public CWnd

Члены

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

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

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

Имя	Описание
CListCtrl::ApproximateViewRect	Указывает ширину и высоту, необходимые для отображения элементов управления "список".
CListCtrl::Arrange	Выравнивает элементы в сетке.
CListCtrl::CancelEditLabel	Отменяет операцию редактирования текста элемента.
CListCtrl::Create	Создает элемент управления "Список" и вложение его к объекту CListCtrl.
CListCtrl::CreateDragImage	Создает список образа перетаскивания для указанного элемента.
CListCtrl::CreateEx	Создает элемент управления "Список" с заданными стилей расширенными Windows и вложение его к объекту CListCtrl.
CListCtrl::DeleteAllItems	Удаляет все элементы из элемента управления.
CListCtrl::DeleteColumn	Удаляет столбец из элемента управления "список".
CListCtrl::DeleteItem	Удаляет элемент из элемента управления.
CListCtrl::DrawItem	Вызываемый, когда визуальный аспект элемента управления рисования владельцем.
CListCtrl::EditLabel	Инициирует редактирование локально текст элемента.
CListCtrl::EnableGroupView	Разрешает или запрещает, отображаются ли элементы в элементе управления "список" как группа.
CListCtrl::EnsureVisible	Гарантирует, что элемент видимым.
CListCtrl::FindItem	Выполняет поиск элемента списка, определяющий характеристики.
CListCtrl::GetBkColor	Возвращает цвет фона элемента управления "список".
CListCtrl::GetBkImage	Извлекает текущее образом фоновое изображение элемента управления "список".
CListCtrl::GetCallbackMask	Извлекает маска обратного вызова для элемента управления "список".
CListCtrl::GetCheck	Получает текущее состояние отображения с образами предыдущего состояния, связанного с элементом.
CListCtrl::GetColumn	Извлекает атрибуты столбцов элемента управления.
CListCtrl::GetColumnOrderArray	Получает порядок столбцов (слева направо) элемента управления "список".
CListCtrl::GetColumnWidth	Получает ширину столбца в представлении или представлении списка отчета.
CListCtrl::GetCountPerPage	Вычисляет количество элементов, которые могут адаптация по вертикали в элементе управления списка.
CListCtrl::GetEditControl	Извлекает маркер элемента управления "Поле ввода" используется для изменения текста элемента.
CListCtrl::GetEmptyText	Извлекает строка, отображаемая, если текущий элемент управления "список" пусто.
CListCtrl::GetExtendedStyle	Извлекает текущие расширенные стили управления "список".
CListCtrl::GetFirstSelectedItemPosition	Получает положение первого выбранного элемента списка в элементе управления "список".
CListCtrl::GetFocusedGroup	Возвращает группу, которая имеет фокус клавиатуры в текущем элементе управления "список".
CListCtrl::GetGroupCount	Получает количество групп в текущем элементе управления "список".
CListCtrl::GetGroupInfo	Возвращает сведения для указанной группы в составе элементе управления списка.
CListCtrl::GetGroupInfoByIndex	Получить данные об указанной группе в текущем элементе управления "список".
CListCtrl::GetGroupMetrics	Извлекает метрики группы.
CListCtrl::GetGroupRect	Возвращает ограничивающий прямоугольник для указанной группы в текущем элементе управления "список".
CListCtrl::GetGroupState	Извлекает состояние для указанной группы в текущем элементе управления "список".
CListCtrl::GetHeaderCtrl	Извлекает элемент управления заголовка элемента управления "список".
CListCtrl::GetHotCursor	Получает курсор, используемый, если включено отслеживание для элемента управления "список".
CListCtrl::GetHotItem	Извлекает элемент списка в данный момент под курсором.
CListCtrl::GetHoverTime	Извлекает текущее время наведения управления "список".
CListCtrl::GetImageList	Извлекает маркер списка образа, используемого для рисования элементов списка.
CListCtrl::GetInsertMark	Получает текущую позицию знака вставки.
CListCtrl::GetInsertMarkColor	Извлекает текущий цвет знака вставки.
CListCtrl::GetInsertMarkRect	Получает прямоугольник, прыгает точка вставки.
CListCtrl::GetItem	Извлекает атрибуты элемента списка.
CListCtrl::GetItemCount	Получает число элементов в элементе управления "список".
CListCtrl::GetItemData	Извлекает конкретного приложения значение, связанное с элементом.
CListCtrl::GetItemIndexRect	Возвращает ограничивающий прямоугольник для все или часть подэлемента в текущем элементе управления "список".
CListCtrl::GetItemPosition	Получает положение элемента списка.
CListCtrl::GetItemRect	Возвращает ограничивающий прямоугольник для элемента.
CListCtrl::GetItemSpacing	Вычисляет интервалы между элементами в текущем элементе управления "список".
CListCtrl::GetItemState	Извлекает состояние элемента списка.
CListCtrl::GetItemText	Извлекает текст элемента или вложенного элемента списка.
CListCtrl::GetNextItem	Выполняет поиск элемента списка с указанными свойствами и с указанным отношением к заданному элементу.
CListCtrl::GetNextItemIndex	Извлекает индекс элемента в текущем элементе управления "список", имеющую указанный набор свойств.
CListCtrl::GetNextSelectedItem	Извлекает индекс положения элемента списка и положение выбранного элемента следующего списка для итерации.
CListCtrl::GetNumberOfWorkAreas	Возвращает текущее количество рабочие области для элемента управления "список".
CListCtrl::GetOrigin	Извлекает начало координат текущего представления для элемента управления "список".
CListCtrl::GetOutlineColor	Возвращает цвет границы элемента управления "список".
CListCtrl::GetSelectedColumn	Извлекает индекс выбранного в данный момент столбца в элементе управления "Список".
CListCtrl::GetSelectedCount	Извлекает число выделенных элементов в элементе управления "список".
CListCtrl::GetSelectionMark	Извлекает маркер выделения управления "список".
CListCtrl::GetStringWidth	Указывает минимальную ширину столбцов необходимую указания на всю из заданной строки.
CListCtrl::GetSubItemRect	Получает ограничивающий прямоугольник элемента в элементе управления "список".
CListCtrl::GetTextBkColor	Возвращает цвет фона текста данного элемента управления "список".
CListCtrl::GetTextColor	Возвращает цвет текста элемента управления "список".
CListCtrl::GetTileInfo	Извлекает сведения о печати мозаику в элементе управления "список".
CListCtrl::GetTileViewInfo	Получить данные об элементе управления списка в представлении напечатать мозаику.
CListCtrl::GetToolTips	Извлекает элемент управления tooltip которому элементе управления списка используется для отображения подсказок.
CListCtrl::GetTopIndex	Извлекает индекс элемента, видимого переднего плана.
CListCtrl::GetView	Возвращает представление элемента управления "список".
CListCtrl::GetViewRect	Возвращает ограничивающий прямоугольник для всех элементов в элементе управления "список".
CListCtrl::GetWorkAreas	Извлекает текущие рабочие области управления "список".
CListCtrl::HasGroup	Определяет, является ли элемент управления списка имеет указанную группу.
CListCtrl::HitTest	Определяет, какой элемент списка в заданной позиции.
CListCtrl::InsertColumn	Вставляет новый столбец в элементе управления списка.
CListCtrl::InsertGroup	Вставляет группу в элементе управления списка.
CListCtrl::InsertGroupSorted	Вставляет указанную группу в упорядоченный список групп.
CListCtrl::InsertItem	Вставляет новый элемент в элементе управления списка.
CListCtrl::InsertMarkHitTest	Извлекает точку вставки ближайшая к заданной точке.
CListCtrl::IsGroupViewEnabled	Указывает, включено ли представление группы для элемента управления "список".
CListCtrl::IsItemVisible	Указывает, является ли указанный элемент в текущем элементе управления "список" является видимым.
CListCtrl::MapIDToIndex	Сопоставляет уникальный идентификатор элемента в текущем элементе управления "список" с индексом.
CListCtrl::MapIndexToID	Сопоставляет индекс элемента в текущем элементе управления "список" с уникальным идентификатором.
CListCtrl::MoveGroup	Перемещает указанную группу.
CListCtrl::MoveItemToGroup	Перемещает указанную группу к определенному нулю, основываясь индексам управления "список".
CListCtrl::RedrawItems	Принудительно элементе управления списка обновить диапазон элементов.
CListCtrl::RemoveAllGroups	Удаляет все группы из элемента управления "список".
CListCtrl::RemoveGroup	Удаляет указанную группу из элемента управления "список".
CListCtrl::Scroll	Прокручивает содержимое элемента управления "список".
CListCtrl::SetBkColor	Устанавливает цвет фона элемента управления "список".
CListCtrl::SetBkImage	Устанавливает текущее образом фоновое изображение элемента управления "список".
CListCtrl::SetCallbackMask	Задает маску обратного вызова для элемента управления "список".
CListCtrl::SetCheck	Устанавливает текущее состояние отображения с образами предыдущего состояния, связанного с элементом.
CListCtrl::SetColumn	Устанавливает атрибуты столбцов списка.
CListCtrl::SetColumnOrderArray	Задает порядок столбцов (слева направо) элемента управления "список".
CListCtrl::SetColumnWidth	Изменяет ширину столбца в представлении или представлении списка отчета.
CListCtrl::SetExtendedStyle	Задает текущие расширенные стили управления "список".
CListCtrl::SetGroupInfo	Задает сведения для указанной группы в составе элементе управления списка.
CListCtrl::SetGroupMetrics	Устанавливает метрики группы управления "список".
CListCtrl::SetHotCursor	Устанавливает курсор, используемый, когда отслеживание включено для элемента управления "список".
CListCtrl::SetHotItem	Задает текущий активный элемент управления "список".
CListCtrl::SetHoverTime	Устанавливает текущее время наведения управления "список".
CListCtrl::SetIconSpacing	Устанавливает расстояние между значками в элементе управления "список".
CListCtrl::SetImageList	Присвоит список завершения образа для элемента управления "список".
CListCtrl::SetInfoTip	Задает текст всплывающей подсказки.
CListCtrl::SetInsertMark	Устанавливает точку вставки с указанной позиции.
CListCtrl::SetInsertMarkColor	Устанавливает цвет точки вставки.
CListCtrl::SetItem	Устанавливает некоторые или все атрибуты элемента списка.
CListCtrl::SetItemCount	Подготавливает элементе управления списка для добавления большое число элементов.
CListCtrl::SetItemCountEx	Устанавливает объем виртуального представления списка элемента управления.
CListCtrl::SetItemData	Задает значение элемента конкретного приложения.
CListCtrl::SetItemIndexState	Устанавливает состояние элемента в текущем элементе управления "список".
CListCtrl::SetItemPosition	Перемещает элемент в указанной позиции в элементе управления "список".
CListCtrl::SetItemState	Изменяет состояние элемента в элементе управления "список".
CListCtrl::SetItemText	Изменяет текст элемента или вложенного элемента списка.
CListCtrl::SetOutlineColor	Задает цвет границы элемента управления "список".
CListCtrl::SetSelectedColumn	Задает выбранный столбец управления "список".
CListCtrl::SetSelectionMark	Размещает метку выделения управления "список".
CListCtrl::SetTextBkColor	Устанавливает цвет фона текста в элементе управления "список".
CListCtrl::SetTextColor	Задает цвет текста элемента управления "список".
CListCtrl::SetTileInfo	Задает сведения для печати мозаику управления "список".
CListCtrl::SetTileViewInfo	Задает сведения, которые элементе управления списка используется в представлении напечатать мозаику.
CListCtrl::SetToolTips	Задает элемент управления tooltip которому элементе управления списка будет использоваться для отображения подсказок.
CListCtrl::SetView	Задает представление элемента управления "список".
CListCtrl::SetWorkAreas	Задает область, в которой значки могут отображаться в элементе управления "список".
CListCtrl::SortGroups	Сортировка групп в составе элементе управления списка с определяемой пользователем функцией.
CListCtrl::SortItems	Сортирует элементы списка, используя заданное сравнение приложение- функции.
CListCtrl::SortItemsEx	Сортирует элементы списка, используя заданное сравнение приложение- функции.
CListCtrl::SubItemHitTest	Определяет, какой элемент списка, если они есть в заданной позиции.
CListCtrl::Update	Принудительно вызывает элемент управления обновить указанный элемент.

Заметки

В дополнение к значку и метке, каждый элемент может иметь сведения, отображаемые в столбцах справа от значка и метки.Этот элемент управления (и, следовательно, класс CListCtrl ) доступны только для программ, выполняемых в рамках /98 Windows версии 3.51 и Windows NT 95 и более поздних версий.

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

Представления

Управления списка могут отображать их содержимого в 4, вызываемых различными способами, "представлениями".

Значки

Каждый элемент отображается в виде полноразрядные точки значка (32 x 32) с меткой под ним.Пользователь может перетащить элементы в любое место в окне списка.
Меньшее представление значков

Каждый элемент отображается в виде маленький значок (16 x 16 точек) с маркерами справа от него.Пользователь может перетащить элементы в любое место в окне списка.
Список

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

Каждый элемент отображается в собственную линии, с дополнительной информации аранжированная в столбцах справа.Крайний левый столбец содержит небольшие значок и метку и последующие столбцы содержат подэлементов, как указано приложением.Внедренный элемент управления заголовка (класс CHeaderCtrl) реализует эти столбцы.Дополнительные сведения об элементе управления заголовков и столбцов в представлении отчета см. в разделе Использование CListCtrl: Добавление столбцов к элементу управления (поскольку отчетов).

См. также:

Q250614 статья базы знаний Майкрософт: Практическое руководство: Сортировка элементов в CListCtrl в виде отчета
Q200054 статья базы знаний Майкрософт: PRB. OnTimer () не вызываются повторно для элемента управления "Список"

Стиль списка элемента управления текущего определяет текущее представление.Дополнительные сведения об этих стилях и их потреблении см. в разделе Использование CListCtrl: Изменение стиля элемента управления "Список".

Расширенные стили

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

Выбор наведением

При активации, обеспечивает автоматическое выделение элемента, если курсор находится над элементом в течение определенного времени.
Виртуальные режим списка

При активации, позволяет элементу управления для поддержки до DWORD элементы.Это возможно с помощью дополнительных издержек управления данными элемента в приложении.За исключением выделения элемента и фокуса, все данные элемента должны быть управляются приложением.Дополнительные сведения см. в разделе Использование CListCtrl: Виртуальные элементы управления "Список".
Активация одного щелчков и 2

При активации, разрешается отслеживание (автоматический выбор текста элемента) и активация одного или 2 щелчков выбранного элемента.
Упорядочивание столбцов перетаскивания

При активации перетаскивания, позволяет изменение порядка столбцов в элементе управления "список".Доступно только в представлении отчета.

Дополнительные сведения об использовании этих новых расширенных стилей см. в разделе Использование CListCtrl: Изменение стиля элемента управления "Список".

Элементы и подэлементов

Каждый элемент в элементе управления "список" состоит из значка (из списка образа), метки текущего состояния и приложение- указанного значения (с именем "данные").Один или несколько подэлементы также можно связать с каждым элементом."Подэлемента" строка, используемая в представлении отчета могут отображаться в столбце справа от значка и меток элементов.Все элементы в элементе управления "список", должны иметь одинаковое число подэлементов.

Класс CListCtrl предоставляет несколько функций вставки, удаления и изменения найти эти элементы.Дополнительные сведения см. в разделе CListCtrl::GetItem, CListCtrl::InsertItem и CListCtrl::FindItem, Использование CListCtrl: Добавление элементов в элемент управления и Использование CListCtrl: Прокрутка, упорядочивать, сортировка и поиск в элементах управления "Список".

По умолчанию элемент управления "список" отвечает за хранение атрибуты значок и текст элемента.Однако в дополнение к этим типам элементов, класс CListCtrl поддерживает "элементы" обратного вызова. "Элемент обратного вызова" элемент списка, для которого приложение —, а не элемент управления — магазины текст, значок или оба.Маска обратного вызова используется для определения того, какие атрибуты элемента (текст и/или значок) предоставьте приложением.Если приложение использует элементы обратного вызова, он должен иметь возможность указать атрибуты текст и/или значка по запросу.Элементы обратного вызова полезны в тех случаях, когда приложение уже поддерживает некоторые из этих сведений.Дополнительные сведения см. в разделе Использование CListCtrl: элементы обратного вызова и маска обратного вызова.

Списки завершения образа

Значки, образы элемента заголовка и указанные объектом применения состояния для элементов списка, содержащиеся в нескольких списков образа (реализованных классом CImageList), необходимо создать и присвоить к элементу управления "список".Каждый элемент управления "список" может содержать до 4 различных типов списков образа.

Большой значок

Используемый в представлении значка для полноразрядных значков.
Маленький значок

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

Содержит изображений состояния, отображаемых рядом с значком элементов для обозначения того приложение- указанному условию.
Элемент заголовка

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

По умолчанию элемент управления "список" уничтожает списки завершения образа, присвоенные него при уничтожении; оно однако разработчик может настраивать этой функциональности путем разрушать каждый список образа, когда он больше не используется, как указано приложением.Дополнительные сведения см. в разделе Использование CListCtrl: Элементы списка и списки завершения образа.