Тип элемента управления TreeItem
В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления TreeItem.
Тип элемента управления TreeItem представляет узел в контейнере дерева. Каждый узел дерева может содержать другие узлы, называемые дочерними узлами. Родительские узлы (т. е. те, которые содержат дочерние узлы) могут отображаться как в развернутом, так и в свернутом виде.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса древовидной структуры, свойств, шаблонов элементов управления и событий для типа элемента управления TreeItem. Требования к модель автоматизации пользовательского интерфейса применяются ко всем элементам управления "Дерево", где платформа пользовательского интерфейса интегрируется модель автоматизации пользовательского интерфейса поддержку типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие подразделы.
- Типичная древовидная структура
- Соответствующие свойства
- Обязательные шаблоны элементов управления
- Обязательные события
- Замечания
- Связанные темы
Типичная древовидная структура
В следующей таблице представлен типичный элемент управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления элементами дерева, и описывается, что может содержаться в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в разделе Общие сведения о дереве модель автоматизации пользовательского интерфейса.
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Элементы управления "Дерево" могут иметь ноль или более дочерних элементов дерева в представлении содержимого дерева модель автоматизации пользовательского интерфейса. Если элемент управления "Дерево" имеет функциональные возможности, превышающие доступные в шаблонах элементов управления, перечисленных ниже, элемент управления должен основываться на типе элемента управления DataItem .
Свернутые элементы дерева не отображаются в представлении элемента управления или представлении содержимого, пока они не станут развернутыми и видимыми (или не могут быть прокручены в представление).
Представление элемента управления может содержать дополнительные сведения для элемента управления, включая связанное изображение или кнопку. Например, элемент в режиме структуры может содержать изображение, а также кнопку для развертывания или свертывания структуры. Эти объекты сведений не отображаются в представлении содержимого, так как информация уже представлена родительским элементом дерева.
Элементы дерева, прокручиваемые с экрана, отображаются как в представлении элементов управления, так и в представлении содержимого дерева модель автоматизации пользовательского интерфейса. Для свойства IUIAutomationElement::CurrentIsOffscreen (или CachedIsOffscreen) должно быть задано значение TRUE.
Соответствующие свойства
В следующей таблице перечислены модель автоматизации пользовательского интерфейса свойства, значение или определение которых особенно относится к типу элемента управления TreeItem. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе Извлечение свойств из элементов модель автоматизации пользовательского интерфейса.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания |
|---|---|---|
| UIA_AutomationIdPropertyId | См. примечания. | Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева модель автоматизации пользовательского интерфейса. |
| UIA_BoundingRectanglePropertyId | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| UIA_ClickablePointPropertyId | См. примечания. | Это свойство должно возвращать расположение, которое приводит к изменению состояния выбора или фокусу элемента дерева. |
| UIA_ControlTypePropertyId | TreeItem | Это значение одинаково для всех инфраструктур пользовательского интерфейса. |
| UIA_IsContentElementPropertyId | TRUE | Элемент управления "Дерево" всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса. |
| UIA_IsControlElementPropertyId | TRUE | Элемент управления "Дерево" всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса. |
| UIA_IsKeyboardFocusablePropertyId | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| UIA_IsOffscreenPropertyId | См. примечания. | Это свойство указывает, прокручивается ли элемент управления "Дерево" с экрана. |
| UIA_ItemStatusPropertyId | См. примечания. | Если элемент управления содержит состояние, которое обновляется динамически, это свойство должно поддерживаться, чтобы специальные возможности могли получать обновления при изменении состояния элемента. |
| UIA_ItemTypePropertyId | См. примечания. | Если элемент управления "Дерево элементов" использует визуальный значок для указания определенного типа элемента, это свойство должно поддерживаться и указывать тип элемента. |
| UIA_LabeledByPropertyId | NULL | Элементы управления "Элемент дерева" получают метки автоматически. |
| UIA_LocalizedControlTypePropertyId | См. примечания. | Локализованная строка, соответствующая типу элемента управления TreeItem. Значение по умолчанию — "элемент дерева" для en-US или english (США). |
| UIA_NamePropertyId | См. примечания. | Это свойство предоставляет текст, отображаемый для каждого элемента управления "Элемент дерева". |
Обязательные шаблоны элементов управления
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления элементами в виде дерева. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления/свойство шаблона | Поддержка/значение | Примечания |
|---|---|---|
| IExpandCollapseProvider | Обязательно | Все элементы дерева должны поддерживать шаблон элемента управления ExpandCollapse , так как все элементы могут быть развернуты или свернуты. |
| ExpandCollapseState | Expanded, Collapsed или Leaf Node | Элементы дерева являются конечными узлами, если они не развернуты или свернуты. |
| IInvokeProvider | Зависит | Реализуйте шаблон элемента управления Вызов, если элемент дерева может выполнять команду. |
| IScrollItemProvider | Зависит | Реализуйте шаблон элемента управления ScrollItem , если контейнер дерева поддерживает шаблон элемента управления Scroll . |
| ISelectionItemProvider | Зависит | Реализуйте шаблон элемента управления SelectionItem , если можно иметь активный выбор, который сохраняется при возврате пользователя в контейнер дерева. |
| SelectionContainer | Обязательно | Это свойство предоставляет один и тот же контейнер для всех элементов в контейнере. |
Обязательные события
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, для поддержки которых требуются элементы управления элементами в виде дерева. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| Событие модель автоматизации пользовательского интерфейса | Примечания |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId событие изменения свойства. | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId событие изменения свойства. | |
| UIA_Invoke_InvokedEventId | Если элемент управления поддерживает шаблон элемента управления Invoke , он должен поддерживать это событие. |
| UIA_IsEnabledPropertyId событие изменения свойства. | Если элемент управления поддерживает свойство IsEnabled , он должен поддерживать это событие. |
| UIA_IsOffscreenPropertyId событие изменения свойства. | Если элемент управления поддерживает свойство IsOffscreen , он должен поддерживать это событие. |
| UIA_ItemStatusPropertyId событие изменения свойства. | Если элемент управления поддерживает свойство ItemStatus , он должен поддерживать это событие. |
| UIA_MultipleViewCurrentViewPropertyId событие изменения свойства. | Если элемент управления поддерживает шаблон элемента управления MultipleView , он должен поддерживать это событие. |
| UIA_NamePropertyId событие изменения свойства. | |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Если элемент управления поддерживает шаблон элемента управления SelectionItem , он должен поддерживать это событие. |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Если элемент управления поддерживает шаблон элемента управления SelectionItem , он должен поддерживать это событие. |
| UIA_SelectionItem_ElementSelectedEventId | Если элемент управления поддерживает шаблон элемента управления SelectionItem , он должен поддерживать это событие. |
| UIA_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId событие изменения свойства. | Если элемент управления поддерживает шаблон элемента управления Toggle , он должен поддерживать это событие. |
| UIA_ValueValuePropertyId событие изменения свойства. | Если элемент управления поддерживает шаблон элемента управления "Значение ", он должен поддерживать это событие. |
Комментарии
Если элемент дерева содержит подэлементы, отличные от дочерних узлов структуры, поставщик должен тщательно и четко обрабатывать сведения о дочернем объекте. В модель автоматизации пользовательского интерфейса древовидная структура обрабатывается самой иерархией дерева. При наличии одного или нескольких дочерних узлов без структуры различия между ними и фактическими дочерними узлами структуры становятся серьезно неоднозначными.
Связанные темы
-
Основные понятия
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса
-
Общие сведения о модели автоматизации пользовательского интерфейса
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по