Элемент управления ListView

Элемент управления ListView, отображающий один столбец значений со значком рядом с каждым элементом. Он позволяет пользователю выбрать одно строковое или целое значение для свойства из предопределенного списка. Возможные значения считываются из таблицы ListView. Элемент управления можно связать с целым числом или строковым значением, введя имя свойства в столбец свойств таблицы Control.

Содержимое поля "Текст" таблицы Control никогда не отображается элементом управления ListView. Вместо этого это поле указывает стиль текста, отображаемого элементом управления, и содержит описание элемента управления, используемого служебными программами проверки экрана. Чтобы задать стиль шрифта и шрифта текстовой строки, префиксировать строку отображаемых символов с помощью {\style} или {&style}. Где стиль — это идентификатор, указанный в столбце TextStyle таблицы TextStyle. Если ни из них нет, но свойство DefaultUIFont определено как допустимый текстовый стиль, этот шрифт будет использоваться. Приведенные ниже сведения считываются служебными программами проверки экрана в качестве описания элемента управления. См . специальные возможности.

Атрибуты элемента управления

С этим элементом управления можно использовать следующие атрибуты. Чтобы изменить значение атрибута с помощью события, подпишите элемент управления ControlEvent в таблице EventMapping и перечислите идентификатор атрибута в столбце атрибута. Введите идентификатор ControlEvent в столбце событий.

Идентификатор атрибута	Шестнадцатеричный бит	Description
НепрямаяpropertyName		Это имя косвенного свойства, связанного с элементом управления. Если задан бит косвенного атрибута, элемент управления отображает или изменяет значение свойства, имеющего это имя. Если задан бит косвенного атрибута, это имя также является значением свойства, указанного в столбце свойств таблицы Control.
Занимаемая должность		Положение элемента управления в диалоговом окне. Введите ширину, высоту и координаты левого угла элемента управления в столбцы Width, Height, X и Y таблицы Control. Используйте единицы установщика для длины и расстояния.
PropertyName		Это имя свойства, связанного с этим элементом управления. Если бит косвенного атрибута не задан, элемент управления отображает или изменяет значение свойства, имеющего это имя. Этот атрибут указан в столбце "Свойство" таблицы Control.
PropertyValue		Текущее значение свойства, отображаемое или измененное этим элементом управления. Если бит косвенного атрибута не задан, это значение PropertyName. Если задан бит непрямого атрибута, это значение IndirectPropertyName. Если атрибут изменяется, элемент управления отражает новое значение.
Text		Чтобы отобразить текст в средства чтения с экрана, введите текст в текстовый столбец таблицы Control. См . специальные возможности.
Visible	0x00000000 0x00000001	Скрытый элемент управления. Видимый элемент управления. Включите этот бит в битовое слово столбца "Атрибуты" в таблице Control, чтобы сделать элемент управления видимым или скрытым при его создании. Вы также можете скрыть или показать элемент управления с помощью таблицы ControlCondition.
Включено	0x00000000 0x00000002	Управление в отключенном состоянии. Управление включенным состоянием. Включите этот бит в битовое слово в столбец "Атрибуты" элемента управления , чтобы включить элемент управления при создании. Вы также можете включить или отключить элемент управления с помощью таблицы ControlCondition.
Затонувший	0x00000000 0x00000004	Отображает визуальный стиль по умолчанию. Отображает элемент управления с 3-D. Включите эти биты в битовое слово в столбец "Атрибуты" таблицы Control.
Косвенные	0x00000000 0x00000008	Элемент управления отображает или изменяет значение свойства в столбце "Свойство" таблицы Control. Элемент управления отображает или изменяет значение свойства, которое содержит идентификатор, указанный в столбце свойств таблицы Control. Определяет, ссылается ли свойство, связанное с этим элементом управления, косвенно.
Целое число	0x00000000 0x00000010	Свойство, связанное с элементом управления, является строковым значением. Свойство, связанное с элементом управления, является целым значением. Включите этот бит в битовое слово столбца "Атрибуты" таблицы Control, чтобы задать этот атрибут при создании элемента управления.
RTLRO	0x00000000 0x00000020	Текст в элементе управления отображается в порядке чтения слева направо. Текст в элементе управления отображается в порядке чтения справа налево.
RightAligned	0x00000000 0x00000040	Текст в элементе управления выровнен по левому краю. Текст в элементе управления выровнен справа.
LeftScroll	0x00000000 0x00000080	Полоса прокрутки расположена справа от элемента управления. Полоса прокрутки расположена слева от элемента управления.
Bidi	0x000000E0	Задайте это значение для сочетания атрибутов RTLRO, RightAligned и LeftScroll .
Сортированные.	0x00000000 0x00010000	Элементы, отображаемые в алфавитном порядке. Элементы, отображаемые в порядке, указанном в таблице ListView. Включите этот бит в битовое слово в столбец "Атрибуты", чтобы отобразить элементы в порядке, указанном столбцом Order таблицы ListView.
Фиксированный размер	0x00000000 0x00100000	Растягивает изображение значка, чтобы он соответствовал элементу управления. Обрезка или центрируется изображение значка в элементе управления. Включите этот бит в битовое слово столбца "Атрибуты" таблицы Control.
Значок	0x00000000 0x00200000 0x00400000 0x00600000	Загружает первый образ. Загружает первый образ 16x16. Загружает первый образ 32x32. Загружает первый образ 48x48. Файл значка может содержать изображения разного размера одного значка. Включите значение соответствующего битового слова в столбец "Атрибуты" таблицы Control Если эти биты не заданы, установщик игнорирует атрибут FixedSize и изображение растянуто, чтобы поместить прямоугольник элемента управления. Если заданы биты IconSize и FixedSize, изображение меньше, чем элемент управления, и изображение больше, чем элемент управления.

 

Замечания

Этот элемент управления можно создать из класса WC_LISTVIEW с помощью функции CreateWindowEx. Он содержит стили LVS_REPORT, LVS_NOCOLUMNHEADER, WS_VSCROLL, WS_HSCROLL, LVS_SHAREIMAGELISTS, LVS_SINGLESEL, LVS_SHOWSELALWAYS, WS_BORDER и WS_TABSTOP. Если бит сортированного стиля не включен, элемент управления также имеет стиль LVS_SORTASCENDING .

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