элемент управления List-View (справочник по элементу пользовательского интерфейса MSAA)
Заметка
В этом разделе описывается List-View объектов управления для целей ссылки на элемент пользовательского интерфейса MSAA. Создание объектов элемента управленияList-View в различных платформах пользовательского интерфейса не описано здесь. См. справочную документацию по API для используемой платформы пользовательского интерфейса.
Элемент управления представлением списка отображает коллекцию элементов, каждый из которых состоит из значка и метки, и предоставляет несколько способов отображения и упорядочивания элементов. Например, дополнительные сведения о каждом элементе отображаются в столбцах справа от значка и метки. В проводнике Windows для отображения файлов используется элемент управления представлением списка.
Имя класса окна для элемента управления представлением списка WC_LISTVIEW, которое определяется как SysListView в Commctrl.h.
Недоступные методы
Элемент управления представлением списка поддерживает следующие методы IAccessible:
| Метод | Комментарии |
|---|---|
| accDoDefaultAction | Сам объект представления списка не имеет свойства DefaultAction; однако метод accDoDefaultAction дважды щелкает элементы представления списка. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
Свойства IAccessible
Элемент управления представлением списка поддерживает следующие свойства IAccessible:
| Свойство | Комментарии |
|---|---|
| get_accChild | |
| get_accChildCount | Свойство ChildCount — это количество элементов в списке. |
| get_accDefaultAction | Сам объект представления списка не имеет свойства DefaultAction; однако свойство defaultAction по умолчанию для каждого элемента представления списка — "Double Click". |
| get_accDescription | Сам объект представления списка не поддерживает свойство Description; однако свойство описания для каждого элемента представления списка — это текст, содержащийся во втором и последующих столбцах элемента. Запятая вставляется между текстом для каждого столбца. |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | Объекты представления списка не имеют сочетаний клавиш. Однако если текст окна для элемента управления представлением списка содержит амперсанд (&) символ, microsoft Active Accessibility возвращает строку, не являющаяся null, как свойство KeyboardShortcut. |
| get_accName | Имя для объекта представления списка получается из текста окна элемента управления (или заголовка). Этот текст не отображается с элементом управления представлением списка, поэтому разработчики серверов должны предоставлять значимый текст в инструкции определения ресурсов элемента управления, чтобы помочь пользователям клиентских служебных программ определить элемент управления. Для элементов представления списка свойство Name является текстом элемента списка. |
| get_accParent | Родительский объекта представления списка — это окно (ROLE_SYSTEM_WINDOW), которое окружает элемент управления и имеет то же имя свойства и имя класса окна, что и элемент управления. Свойство Parent элементов представления списка является объектом представления списка. |
| get_accRole | ролиROLE_SYSTEM_LIST, а каждый элемент в элементе управления представлением списка имеет свойство RoleROLE_SYSTEM_LISTITEM. |
| get_accSelection | |
| get_accState | Свойство состояния объекта представления списка — это сочетание одного или нескольких следующих значений : STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN Свойство состояния элементов представления списка — это сочетание одного или нескольких из следующих значений: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_OFFSCREEN | STATE_SYSTEM_NORMAL Кроме того, элементы представления списка флажка также имеют состояние STATE_SYSTEM_CHECKED. |
Примечания
- Microsoft Active Accessibility не предоставляет текст элемента представления списка в приложениях, использующих функцию обратного вызова для добавления текста в элемент.
- Элементы представления списка, обрезанные, не имеют STATE_SYSTEM_INVISIBLE набор. Чтобы определить, обрезается ли элемент списка, клиенты могут сравнить координаты элемента, возвращаемые accLocation с областью вырезки окна.
- Microsoft Active Accessibility не поддерживает использование метода accNavigate для перехода к элементу управления заголовка в элементе управления представления списка, который находится в представлении сведений. Однако клиенты используют функцию AccessibleObjectFromPoint для доступа к элементу управления заголовком.
- Для не прямоугольных объектов, таких как элементы представления списка в представлении сведений, координаты ограничивающего прямоугольника элемента, полученного accLocation, завершаются ошибкой при тестировании с помощью accHitTest, так как accHitTest определяет границы объекта на основе пикселя по пикселям.