Поделиться через

Тип элемента управления TreeItem

  • Статья

В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления TreeItem.

Тип элемента управления TreeItem представляет узел в контейнере дерева. Каждый узел дерева может содержать другие узлы, называемые дочерними узлами. Родительские узлы (т. е. те, которые содержат дочерние узлы) могут отображаться как в развернутом, так и в свернутом виде.

В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса древовидной структуры, свойств, шаблонов элементов управления и событий для типа элемента управления TreeItem. Требования к модель автоматизации пользовательского интерфейса применяются ко всем элементам управления "Дерево", где платформа пользовательского интерфейса интегрируется модель автоматизации пользовательского интерфейса поддержку типов элементов управления и шаблонов элементов управления.

В этом разделе содержатся следующие подразделы.

Типичная древовидная структура

В следующей таблице представлен типичный элемент управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления элементами дерева, и описывается, что может содержаться в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в разделе Общие сведения о дереве модель автоматизации пользовательского интерфейса.

Представление элемента управления Представление содержимого
  • TreeItem
    • CheckBox (0 или 1)
    • Image (0 или 1)
    • Button (0 или 1)
    • TreeItem (0 или более)
  • TreeItem
    • TreeItem (0 или более)

 

Элементы управления "Дерево" могут иметь ноль или более дочерних элементов дерева в представлении содержимого дерева модель автоматизации пользовательского интерфейса. Если элемент управления "Дерево" имеет функциональные возможности, превышающие доступные в шаблонах элементов управления, перечисленных ниже, элемент управления должен основываться на типе элемента управления 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 событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления "Значение ", он должен поддерживать это событие.

 

Комментарии

Если элемент дерева содержит подэлементы, отличные от дочерних узлов структуры, поставщик должен тщательно и четко обрабатывать сведения о дочернем объекте. В модель автоматизации пользовательского интерфейса древовидная структура обрабатывается самой иерархией дерева. При наличии одного или нескольких дочерних узлов без структуры различия между ними и фактическими дочерними узлами структуры становятся серьезно неоднозначными.

Основные понятия

Общие сведения о типах элементов управления автоматизации пользовательского интерфейса

Общие сведения о модели автоматизации пользовательского интерфейса