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