Тип элемента управления "Дерево"
В этом разделе содержатся сведения о поддержке службы автоматизации пользовательского интерфейса Майкрософт для типа элемента управления дерева.
Тип элемента управления дерево используется для контейнеров, содержимое которых имеет релевантность в качестве иерархии узлов, как и способ отображения файлов и папок в левой области проводника Windows. Каждый узел может содержать другие узлы, называемые дочерними узлами. Родительские узлы или узлы, содержащие дочерние узлы, могут отображаться как развернутые или свернутые. Элемент управления "Дерево" Windows (как определено WC_TREEVIEW) является примером элемента управления, который принадлежит типу элемента управления Дерево.
В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления дерево. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления деревом, где платформа и платформа пользовательского интерфейса интегрирует поддержку автоматизации пользовательского интерфейса для типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие разделы.
- типичная структура дерева
- соответствующие свойства
- обязательные шаблоны элементов управления
- обязательные события
- связанные разделы
Типичная структура дерева
В следующей таблице представлено типичное представление элемента управления и содержимого дерева автоматизации пользовательского интерфейса, относящегося к элементам управления дерева, и описывает, что можно содержать в каждом представлении. Дополнительные сведения о дереве автоматизации пользовательского интерфейса см. в обзоре дерева автоматизации пользовательского интерфейса.
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Представление элемента управления дерева автоматизации пользовательского интерфейса состоит из следующих элементов:
- Ноль многих элементов в контейнере (элементы могут основываться на типах элементов управления TreeItem или DataItem).
- Ноль, один или два элемента управления полосы прокрутки
Представление содержимого дерева автоматизации пользовательского интерфейса состоит из нуля или множества элементов в контейнере (элементы могут быть основаны на TreeItem или типах элементов управления DataItem).
Соответствующие свойства
В следующей таблице перечислены свойства автоматизации пользовательского интерфейса, значение или определение которых особенно важно для типа элемента управления дерево. Дополнительные сведения о свойствах автоматизации пользовательского интерфейса см. в получения свойств из элементов автоматизации пользовательского интерфейса.
| Свойство автоматизации пользовательского интерфейса | Ценность | Примечания |
|---|---|---|
| UIA_AutomationIdPropertyId | См. заметки. | Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса. |
| UIA_BoundingRectanglePropertyId | См. заметки. | Самый внешний прямоугольник, содержащий весь элемент управления. |
| UIA_ClickablePointPropertyId | См. заметки. | Элементы управления "Дерево" имеют точку щелчка, которая приводит к тому, что дерево или один из элементов в контейнере дерева будет получать фокус. Элемент управления деревом может иметь точку, доступную для щелчка, только если можно щелкнуть расположение в дереве, не вызывая выбор элемента или получение фокуса. |
| UIA_ControlTypePropertyId | дерева | Это значение одинаково для всех платформ пользовательского интерфейса. |
| UIA_IsContentElementPropertyId | ИСТИННЫЙ | Элемент управления "Дерево" всегда включается в представление содержимого дерева автоматизации пользовательского интерфейса. |
| UIA_IsControlElementPropertyId | ИСТИННЫЙ | Элемент управления "Дерево" всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса. |
| UIA_IsKeyboardFocusablePropertyId | См. заметки. | Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство. |
| UIA_LabeledByPropertyId | См. заметки. | Если элемент управления "Дерево" связан с ним меткой, это свойство возвращает указатель IUIAutomationElement указателем для этой метки. В противном случае свойство возвращает ссылку null. |
| UIA_LocalizedControlTypePropertyId | См. заметки. | Локализованная строка, соответствующая типу элемента управления дерева. Значение по умолчанию — "дерево" для en-US или английского языка (США). |
| UIA_NamePropertyId | См. заметки. | Значение свойства имени элемента управления деревом обычно поступает из текста, который метки элемента управления. Если текстовой метки нет, необходимо указать значение для этого свойства. |
Обязательные шаблоны элементов управления
В следующей таблице перечислены шаблоны элементов управления автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления деревом. Дополнительные сведения о шаблонах элементов управления см. в шаблонах элементов управления автоматизации пользовательского интерфейса.
| Управление шаблоном или свойством шаблонов | Поддержка и значение | Примечания |
|---|---|---|
| IScrollProvider | Зависит | Реализуйте шаблон элемента управления прокрутки прокрутки, если элементы в контейнере дерева можно прокрутить. |
| ISelectionProvider | Зависит | Элементы управления "Дерево", содержащие набор элементов, доступных для выбора, должны реализовать шаблон элемента управления выбора. Его не нужно реализовать, если выбор элемента не передает никаких значимых сведений пользователю. |
| CanSelectMultiple | См. заметки. | Реализуйте это свойство, если элемент управления "Дерево" поддерживает несколько выбора (большинство элементов управления деревом не поддерживают несколько выборок). |
| IsSelectionRequired | См. заметки. | Значение этого свойства предоставляется, если элемент управления требует выбора элемента. |
Обязательные события
В следующей таблице перечислены события автоматизации пользовательского интерфейса, которые должны поддерживать все элементы управления деревом. Дополнительные сведения о событиях см. в обзоре событий автоматизации пользовательского интерфейса.
| Событие автоматизации пользовательского интерфейса | Примечания |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| событие UIA_BoundingRectanglePropertyId изменено свойством. | |
| событие UIA_IsEnabledPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие. |
| событие UIA_IsOffscreenPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие. |
| событие UIA_ScrollHorizontallyScrollablePropertyId изменено свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| событие UIA_ScrollHorizontalScrollPercentPropertyId изменено свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| UIA_ScrollHorizontalViewSizePropertyId событие, измененное свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| событие UIA_ScrollVerticalScrollPercentPropertyId изменено свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| событие UIA_ScrollVerticallyScrollablePropertyId изменено свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| UIA_ScrollVerticalViewSizePropertyId событие изменения свойства. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| UIA_Selection_InvalidatedEventId | Если элемент управления поддерживает шаблон элемента управления selection, он должен поддерживать это событие. |
| UIA_StructureChangedEventId |
Связанные разделы
-
концептуальные
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса