Поделиться через

Элемент управления 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 определяет границы объекта на основе пикселя по пикселям.

Интерфейс IAccessible