Тип элемента управления "Дерево"
В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления "Дерево".
Тип элемента управления "Дерево" используется для контейнеров, содержимое которых имеет отношение к иерархии узлов, как и для отображения файлов и папок в левой области Windows Обозреватель. Каждый узел может содержать другие узлы, называемые дочерними узлами. Родительские узлы (т. е. те, которые содержат дочерние узлы) могут отображаться как в развернутом, так и в свернутом виде. Элемент управления в виде дерева Windows (как определено WC_TREEVIEW) является примером элемента управления, который относится к типу элемента управления "Дерево ".
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса древовидной структуры, свойств, шаблонов элементов управления и событий для типа элемента управления "Дерево". Требования к модель автоматизации пользовательского интерфейса применяются ко всем элементам управления "Дерево", где платформа пользовательского интерфейса интегрируется модель автоматизации пользовательского интерфейса поддержку типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие подразделы.
- Типичная древовидная структура
- Соответствующие свойства
- Обязательные шаблоны элементов управления
- Обязательные события
- Связанные темы
Типичная древовидная структура
В следующей таблице представлен типичный элемент управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления "Дерево", и описывается, что может содержаться в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в разделе Общие сведения о дереве модель автоматизации пользовательского интерфейса.
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Представление элемента управления дерева модель автоматизации пользовательского интерфейса состоит из следующих элементов:
- Ноль из множества элементов в контейнере (элементы могут быть основаны на типах элементов управления TreeItem или DataItem ).
- ноль, один или два элемента управления "Полоса прокрутки".
Представление содержимого дерева модель автоматизации пользовательского интерфейса состоит из нуля или нескольких элементов в контейнере (элементы могут быть основаны на типах элементов управления TreeItem или DataItem).
Соответствующие свойства
В следующей таблице перечислены модель автоматизации пользовательского интерфейса свойства, значение или определение которых особенно важно для типа элемента управления "Дерево". Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе Извлечение свойств из элементов модель автоматизации пользовательского интерфейса.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания |
|---|---|---|
| UIA_AutomationIdPropertyId | См. примечания. | Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева модель автоматизации пользовательского интерфейса. |
| UIA_BoundingRectanglePropertyId | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| UIA_ClickablePointPropertyId | См. примечания. | Элементы управления "Дерево" имеют доступную для щелчка точку, которая приводит к тому, что дерево или один из элементов в контейнере дерева получает фокус. Элемент управления "Дерево" может иметь кликабельную точку только в том случае, если можно щелкнуть расположение в дереве без выделения элемента или получения фокуса. |
| UIA_ControlTypePropertyId | Дерево | Это значение одинаково для всех инфраструктур пользовательского интерфейса. |
| UIA_IsContentElementPropertyId | TRUE | Элемент управления "Дерево" всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса. |
| UIA_IsControlElementPropertyId | TRUE | Элемент управления "Дерево" всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса. |
| UIA_IsKeyboardFocusablePropertyId | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| UIA_LabeledByPropertyId | См. примечания. | Если с элементом управления "Дерево" связана метка, это свойство возвращает указатель IUIAutomationElement для этой метки. В противном случае свойство возвращает пустую ссылку. |
| UIA_LocalizedControlTypePropertyId | См. примечания. | Локализованная строка, соответствующая типу элемента управления "Дерево ". Значение по умолчанию — "tree" для en-US или english (США). |
| UIA_NamePropertyId | См. примечания. | Значение свойства имени элемента управления "Дерево" обычно берется из текста метки этого элемента управления. Если текстовой метки нет, необходимо указать значение для этого свойства. |
Обязательные шаблоны элементов управления
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления в виде дерева. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления/свойство шаблона | Поддержка/значение | Примечания |
|---|---|---|
| IScrollProvider | Зависит | Реализуйте шаблон элемента управления Прокрутка , если элементы в контейнере дерева можно прокручивать. |
| ISelectionProvider | Зависит | Элементы управления "Дерево", содержащие набор доступных для выбора элементов, должны реализовывать шаблон элемента управления "Выделение ". Его не нужно реализовывать, если выбор элемента не передает пользователю значимых сведений. |
| CanSelectMultiple | См. примечания. | Реализуйте это свойство, если элемент управления "Дерево" поддерживает выбор нескольких элементов (большинство элементов управления дерева не поддерживает выбор нескольких элементов). |
| IsSelectionRequired | См. примечания. | Значение этого свойства предоставляется, если необходимо выбрать элемент управления. |
Обязательные события
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления в виде дерева. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| Событие модель автоматизации пользовательского интерфейса | Примечания |
|---|---|
| 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 |
Связанные темы
-
Основные понятия
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса
-
Общие сведения о модели автоматизации пользовательского интерфейса
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по