Элемент управления 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 в качестве первого активного элемента управления необходимо сделать текстовое поле, относящееся к полю редактирования, первым активным элементом управления в таблице диалоговых окон. Так как статический текст не может сосредоточиться, когда диалоговое окно создается поле редактирования, изначально будет иметь фокус, но это гарантирует, что средства чтения с экрана отображают правильные сведения.