Расширенные стили List-View

Используйте сообщение LVM_SETEXTENDEDLISTVIEWSTYLE или один из макросов ListView_SetExtendedListViewStyle или ListView_SetExtendedListViewStyleEx , чтобы использовать эти расширенные стили элементов управления представления списка.

Константа Описание
LVS_EX_AUTOAUTOARRANGE
Windows Vista и более поздних версий. Автоматически упорядочивать значки, если не задано ни одно положение значков (аналогично LVS_AUTOARRANGE).
LVS_EX_AUTOCHECKSELECT
Windows Vista и более поздних версий. Автоматически выбирайте поля проверка одним щелчком мыши.
LVS_EX_AUTOSIZECOLUMNS
Windows Vista и более поздних версий. Автоматический размер столбцов listview.
LVS_EX_BORDERSELECT
Версия 4.71 и более поздние. Изменяет цвет границы при выборе элемента вместо выделения элемента.
LVS_EX_CHECKBOXES
Версия 4.70. Включает поля проверка для элементов в элементе управления представления списка. Если задан этот стиль, элемент управления создает и задает список изображений состояния с двумя изображениями с помощью DrawFrameControl. Изображение состояния 1 — это снятый флажок, а изображение состояния 2 — это флажок. Если задать для образа состояния нулевое значение, поле проверка будет удалено.
Версия 6.00 и более поздние версии Флажки видны и работают во всех режимах представления списка, за исключением режима представления плиток, появившиеся в ComCtl32.dll версии 6. При нажатии флажка в режиме представления плитки выбирается только элемент; состояние не меняется.
Вы можете получить состояние поля проверка для заданного элемента с ListView_GetCheckState. Чтобы задать состояние проверка, используйте ListView_SetCheckState. Если этот стиль задан, элемент управления представлением списка автоматически переключает состояние проверка, когда пользователь щелкает поле проверка или нажимает пробел.
LVS_EX_COLUMNOVERFLOW
Указывает, что кнопка переполнения должна отображаться в представлении значка или плитки, если недостаточно ширины клиента для отображения полного набора элементов заголовка. Элемент управления представлением списка отправляет уведомление LVN_COLUMNOVERFLOWCLICK при нажатии кнопки переполнения. Этот флаг действителен только при указании LVS_EX_HEADERINALLVIEWS.
LVS_EX_COLUMNSNAPPOINTS
Windows Vista и более поздних версий. Прикрепите к минимальной ширине столбца, когда пользователь изменяет размер столбца.
LVS_EX_DOUBLEBUFFER
Версия 6.00 и более поздняя. Краска с помощью двойной буферизации, что уменьшает мерцание. Этот расширенный стиль также позволяет выбирать области с альфа-смешения в системах, где он поддерживается.
LVS_EX_FLATSB
Включает плоские полосы прокрутки в представлении списка. Если вам нужно больше контроля над внешним видом полос прокрутки представления списка, следует управлять полосами прокрутки представления списка непосредственно с помощью API-интерфейсов плоской полосы прокрутки. Если системные метрики изменяются, вы отвечаете за настройку метрик полосы прокрутки с помощью FlatSB_SetScrollProp. Дополнительные сведения см. в разделе Плоские полосы прокрутки .
LVS_EX_FULLROWSELECT
При выборе элемента он и все его подэлементы выделяются. Этот стиль доступен только в сочетании со стилем LVS_REPORT .
LVS_EX_GRIDLINES
Отображает линии сетки вокруг элементов и вложенных элементов. Этот стиль доступен только в сочетании со стилем LVS_REPORT .
LVS_EX_HEADERDRAGDROP
Включает перетаскивание переупорядочение столбцов в элементе управления представления списка. Этот стиль доступен только для элементов управления представления списка, использующих стиль LVS_REPORT .
LVS_EX_HEADERINALLVIEWS
Windows Vista и более поздних версий. Отображение заголовков столбцов во всех режимах представления.
LVS_EX_HIDELABELS
Версия 6.00 и более поздняя. Скрывает метки в представлении значков и небольших значков.
LVS_EX_INFOTIP
Если элемент управления представлением списка использует стиль LVS_EX_INFOTIP , код уведомления LVN_GETINFOTIP отправляется в родительское окно перед отображением подсказки элемента.
LVS_EX_JUSTIFYCOLUMNS
Windows Vista и более поздних версий. Значки выстраивается в столбцы, которые используют все представление.
LVS_EX_LABELTIP
Если частично скрытая метка в режиме представления списка не содержит текста подсказки, элемент управления представлением списка развернет метку. Если этот стиль не задан, элемент управления представлением списка будет разворачивать частично скрытые метки только для режима больших значков.
LVS_EX_MULTIWORKAREAS
Если элемент управления представлением списка имеет стиль LVS_AUTOARRANGE , элемент управления не будет автоматически упорядочить свои значки, пока не будет определена одна или несколько рабочих областей (см. LVM_SETWORKAREAS). Для эффективной работы этот стиль должен быть задан перед определением рабочих областей и добавлением всех элементов в элемент управления .
LVS_EX_ONECLICKACTIVATE
Элемент управления представлением списка отправляет код уведомления LVN_ITEMACTIVATE в родительское окно, когда пользователь щелкает элемент. Этот стиль также включает горячее отслеживание в элементе управления "Представление списка". Горячее отслеживание означает, что при перемещении курсора над элементом он выделяется, но не выбирается. Сведения об активации элемента см. в разделе Расширенные примечания стилей List-View.
LVS_EX_REGIONAL
Только с версии 4.71 до версии 5.80. Не поддерживается в Windows Vista и более поздних версиях. Задает область окна представления списка для включения только значков элементов и текста с помощью SetWindowRgn. Любая область, которая не является частью элемента, исключается из области окна. Этот стиль доступен только для элементов управления представления списка, использующих стиль LVS_ICON .
LVS_EX_SIMPLESELECT
Версия 6.00 и более поздняя. В представлении значков перемещает изображение состояния элемента управления в правом верхнем углу отрисовки большого значка. В представлениях, отличных от представления значков, изменения отсутствуют. Когда пользователь изменяет состояние с помощью пробела, все выбранные элементы циклически, а не элемент с фокусом.
LVS_EX_SINGLEROW
Версия 6.00 и более поздняя. Не используется.
LVS_EX_SNAPTOGRID
Версия 6.00 и более поздняя. В представлении значков значки автоматически привязываются к сетке.
LVS_EX_SUBITEMIMAGES
Позволяет отображать изображения для вложенных элементов. Этот стиль доступен только в сочетании со стилем LVS_REPORT .
LVS_EX_TRACKSELECT
Включает горячий выбор в элементе управления представлением списка. Выбор горячей дорожки означает, что элемент выбирается автоматически, когда курсор остается над элементом в течение определенного периода времени. Задержку можно изменить по сравнению с системным параметром по умолчанию с помощью сообщения LVM_SETHOVERTIME . Этот стиль применяется ко всем стилям элемента управления list-view. Вы можете проверка, включен ли выбор горячей дорожки, вызвав SystemParametersInfo.
LVS_EX_TRANSPARENTBKGND
Windows Vista и более поздних версий. Фон рисуется родительским элементом с помощью WM_PRINTCLIENT.
LVS_EX_TRANSPARENTSHADOWTEXT
Windows Vista и более поздних версий. Включите теневой текст только на прозрачном фоне.
LVS_EX_TWOCLICKACTIVATE
Элемент управления "Представление списка" отправляет код уведомления LVN_ITEMACTIVATE в родительское окно, когда пользователь дважды щелкает элемент. Этот стиль также включает горячее отслеживание в элементе управления list-view. Горячее отслеживание означает, что при наведении курсора на элемент он выделяется, но не выбирается. Обсуждение активации элемента см. в разделе Примечания расширенных стилей List-View.
LVS_EX_UNDERLINECOLD
Приводит к отображению неактивных элементов, которые могут быть активированы с подчеркнутым текстом. Для этого стиля также требуется задать LVS_EX_TWOCLICKACTIVATE . Обсуждение активации элемента см. в разделе Примечания расширенных стилей List-View.
LVS_EX_UNDERLINEHOT
Вызывает отображение горячих элементов, которые могут быть активированы, с подчеркнутым текстом. Для этого стиля также требуется задать LVS_EX_ONECLICKACTIVATE или LVS_EX_TWOCLICKACTIVATE . Обсуждение активации элемента см. в разделе Примечания расширенных стилей List-View.

Комментарии

Примечание

Comctl32.dll версии 6 не является распространяемым, но включена в Windows. Чтобы использовать Comctl32.dll версии 6, укажите его в манифесте. Дополнительные сведения о манифестах см. в разделе Включение визуальных стилей.

Элемент становится горячим при наведении на него указателя мыши. Если горячее отслеживание включено, будут выделены горячие элементы, но пользователь должен щелкнуть элемент хотя бы один раз, чтобы выбрать его. Активация элемента приводит к тому, что элемент управления представлением списка отправляет уведомление LVN_ITEMACTIVATE . Элемент может быть выбран , когда он находится в состоянии, в котором он будет выбран одним щелчком мыши.

Если задан стиль LVS_EX_ONECLICKACTIVATE , для выбора любого элемента требуется только один щелчок, поэтому можно выбрать все элементы. Если задан стиль LVS_EX_TWOCLICKACTIVATE , для выбора элемента требуется два щелчка мыши. При использовании этого стиля элемент можно выбрать только после того, как он был щелкнут один раз.

Если задать стиль LVS_EX_UNDERLINEHOT , текст любого горячего элемента, который может быть выбран, будет подчеркнут. Установка стиля LVS_EX_UNDERLINECOLD приведет к тому, что текст элементов, которые не являются горячими, но могут быть выбраны, будут подчеркнут.

Требования

Требование Значение
Заголовок
CommCtrl.h

См. также раздел

Стили расширенных List-View