Элемент управления 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. Однако свойство Description для каждого элемента представления списка является текстом, содержащимся во втором и последующих столбцах элемента. Запятая вставляется между текстом для каждого столбца. |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | Объекты представления списка не имеют сочетаний клавиш. Однако если текст окна для элемента управления представлением списка содержит амперсанд (&) символ, Microsoft Active Accessibility возвращает строку без значения NULL в качестве свойства KeyboardShortcut . |
| get_accName | Имя объекта представления списка получается из текста окна элемента управления (или подпись). Этот текст не отображается с элементом управления представлением списка, поэтому разработчики серверов должны предоставлять значимый текст в инструкции определения ресурсов элемента управления, чтобы помочь пользователям клиентских служебных программ определить элемент управления. Для элементов представления списка свойство Name — это текст элемента списка. |
| get_accParent | Родительский объект представления списка — это окно (ROLE_SYSTEM_WINDOW), которое окружает элемент управления и имеет то же свойство Name и имя класса окна, что и элемент управления. Родительское свойство элементов представления списка является объектом представления списка. |
| get_accRole | Роль ROLE_SYSTEM_LIST, а каждый элемент в элементе управления представлением списка имеет свойство Role ROLE_SYSTEM_LISTITEM. |
| get_accSelection | |
| get_accState | Свойство State объекта представления списка — это сочетание одного или нескольких следующих значений: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE STATE_SYSTEM_FOCUSED | | STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_OFFSCREEN | Свойство State элементов представления списка — это сочетание одного или нескольких из следующих значений: | | | | | | | 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 определяет границы объекта на основе пикселя по пикселям.