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


Тип элемента управления "Дерево"

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

Тип элемента управления "Дерево" используется для контейнеров, содержимое которых имеет отношение к иерархии узлов, как и для отображения файлов и папок в левой области Windows Обозреватель. Каждый узел может содержать другие узлы, называемые дочерними узлами. Родительские узлы (т. е. те, которые содержат дочерние узлы) могут отображаться как в развернутом, так и в свернутом виде. Элемент управления в виде дерева Windows (как определено WC_TREEVIEW) является примером элемента управления, который относится к типу элемента управления "Дерево ".

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

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

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

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

Представление элемента управления Представление содержимого
  • Дерево
    • DataItem (0 или более)
    • TreeItem (0 или более)
      • TreeItem (0 или более)
        • ...
    • ScrollBar (0, 1, 2)
  • Дерево
    • DataItem (0 или более)
    • TreeItem (0 или более)
      • TreeItem (0 или более)
        • ...

 

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

  • Ноль из множества элементов в контейнере (элементы могут быть основаны на типах элементов управления 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

 

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

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

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