Элемент управления "Представление в виде дерева" (справочник по элементам пользовательского интерфейса MSAA)

  • Статья

Примечание

В этом разделе описываются объекты элемента управления представлением в виде дерева для справки по элементам пользовательского интерфейса MSAA. Создание объектов элемента управления "Представление в виде дерева " в различных платформах пользовательского интерфейса не описано здесь. См. справочную документацию по API для используемой платформы пользовательского интерфейса.

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

Имя класса окна для элемента управления представлением в виде дерева — WC_TREEVIEW, которое в Commctrl.h определено как SysTreeView.

Методы IAccessible

Элемент управления представлением в виде дерева поддерживает следующие методы IAccessible :

Метод Комментарии
accDoDefaultAction Сам объект представления в виде дерева не имеет метода accDoDefaultAction . В зависимости от свойства State элемента в древовидном представлении accDoDefaultAction разворачивает или сворачивает указанный элемент.
accHitTest
AccLocation
accNavigate
accSelect

Свойства IAccessible

Элемент управления представлением в виде дерева поддерживает следующие свойства IAccessible :

Свойство Комментарии
get_accChild
get_accChildCount Свойство ChildCount для объекта представления в виде дерева — это количество элементов, содержащихся в древовидном представлении. Свойство ChildCount для каждого элемента представления в виде дерева равно нулю.
get_accDefaultAction Сам объект представления в виде дерева не имеет свойства DefaultAction . Элемент в древовидном представлении, который развернут, имеет значение Collapse в качестве свойства DefaultAction , а элемент, который не развернут, имеет значение Expand в качестве свойства DefaultAction .
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut
get_accName Свойство Name для объекта представления в виде дерева получается из текста окна элемента управления (или подпись). Этот текст не отображается в элементе управления представлением в виде дерева, поэтому разработчики сервера должны предоставить осмысленный текст в инструкции определения ресурсов элемента управления, чтобы помочь пользователям клиентских служебных программ определить элемент управления. Свойство Name для элемента в древовидном представлении — это текст, отображаемый в элементе древовидного представления.
get_accParent Свойство Parent объекта представления в виде дерева — это окно ( ROLE_SYSTEM_WINDOW ), которое окружает элемент управления и имеет то же свойство Name и имя класса окна, что и элемент управления . Свойство Parent каждого элемента в древовидном представлении является объектом представления в виде дерева.
get_accRole Объект представления в виде дерева имеет свойство RoleROLE_SYSTEM_OUTLINE. Каждый элемент в древовидном представлении имеет свойство RoleROLE_SYSTEM_OUTLINEITEM.
get_accSelection
get_accState Свойство State для древовидного представления представляет собой сочетание одного или нескольких из следующих значений: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE
Для элементов представления в виде дерева свойство State включает STATE_SYSTEM_EXPANDED или STATE_SYSTEM_COLLAPSED.
Дополнительные возможные значения для свойства State :
| STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED STATE_SYSTEM_HOTTRACKED
get_accValue Объект представления в виде дерева не имеет значения. Свойство Value для каждого элемента представления в виде дерева — это уровень отступа элемента в иерархии. Например, в Windows Обозреватель элемент "Рабочий стол" имеет свойство Value "0", элемент "Мой компьютер", который находится на следующем уровне иерархии, имеет свойство Value "1", а каждый диск, который находится на следующем уровне иерархии, имеет свойство Value "2".

Примечания

Свойство accLocation элементов представления в виде дерева возвращает расположение только текста в элементе. Координаты, возвращаемые accLocation для элементов представления в виде дерева, не включают значок, расположенный слева от текста.

Интерфейс IAccessible