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

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

Замечание

Эта документация предназначена для разработчиков .NET Framework, которые хотят использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в разделе API автоматизации Windows: автоматизация пользовательского интерфейса.

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

Тип элемента управления "Дерево" используется для контейнеров, содержимое которых имеет релевантность в качестве иерархии узлов, как и при отображении файлов и папок в левой области Microsoft Windows Explorer. Каждый узел может содержать другие узлы, называемые дочерними узлами. Родительские узлы или узлы, содержащие дочерние узлы, могут отображаться как развернутые или свернутые.

В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления "Дерево". Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления дерева, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.

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

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

Вид управления Просмотр содержимого
Дерево

  • DataItem (0 или более)
  • TreeItem (0 или более)

    • TreeItem (0 или более)• ...
  • ScrollBar (0, 1, 2)
 Дерево

  • DataItem (0 или более)
  • TreeItem (0 или более)

    • TreeItem (0 или более)• ...

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

  • От нуля до множества элементов в контейнере (элементы могут быть основаны на элементе дерева, элементе данных или другом типе элемента управления).

  • Ноль, одна или две полосы прокрутки.

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

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

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

Свойство автоматизации пользовательского интерфейса Ценность Примечания.
AutomationIdProperty См. заметки. Значение этого свойства должно быть уникальным для всех элементов управления в приложении.
BoundingRectangleProperty См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
ClickablePointProperty См. заметки. Элементы управления "Дерево" имеют область, куда можно щелкнуть, в результате чего фокус установится на дерево или один из элементов в контейнере дерева. Вы получаете точку для щелчка в древовидной структуре, только если можете щелкнуть в месте, которое не приводит к выбору или фокусу одного из элементов.
ControlTypeProperty Дерево Это значение одинаково для всех платформ пользовательского интерфейса.
IsContentElementProperty Верно Элемент управления "Дерево" всегда включается в представление содержимого дерева автоматизации пользовательского интерфейса.
IsControlElementProperty Верно Элемент управления "Дерево" всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса.
IsKeyboardFocusableProperty См. заметки. Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
LabeledByProperty См. заметки. Если к элементу управления деревом связана метка, то это свойство вернет AutomationElement для этой метки. В противном случае свойство вернет пустую ссылку (Nothing в Microsoft Visual Basic .NET).
LocalizedControlTypeProperty "дерево" Локализованная строка, соответствующая типу элемента управления List.
NameProperty См. заметки. Значение свойства имени элемента управления деревом обычно поступает из текста, который метки элемента управления. Если текстовой метки нет, разработчик приложения должен указать значение для этого свойства.

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

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

Управление шаблоном или свойством шаблонов Поддержка и значение Примечания.
ISelectionProvider Зависит Элементы управления "Дерево", содержащие набор элементов, доступных для выбора, должны реализовать этот шаблон элемента управления. Этот шаблон элемента управления не должен быть реализован, если выбор элемента не передает значимые сведения пользователю.
CanSelectMultiple См. заметки. Реализуйте это свойство, если элемент управления "Дерево" поддерживает несколько выбора (большинство элементов управления деревом не поддерживают несколько выборок).
IsSelectionRequired См. заметки. Значение этого свойства предоставляется, если элемент управления требует выбора элемента.
IScrollProvider Зависит Реализуйте этот шаблон управления, если содержимое контейнера дерева можно прокрутить.

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

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

Событие автоматизации пользовательского интерфейса Поддержка Примечания.
InvalidatedEvent Зависит Отсутствует
BoundingRectangleProperty событие изменения свойства. Обязательно Отсутствует
IsOffscreenProperty событие изменения свойства. Обязательно Отсутствует
IsEnabledProperty событие изменения свойства. Обязательно Отсутствует
HorizontallyScrollableProperty событие изменения свойства. Зависит Отсутствует
HorizontalScrollPercentProperty событие изменения свойства. Зависит Отсутствует
HorizontalViewSizeProperty событие изменения свойства. Зависит Отсутствует
VerticalScrollPercentProperty событие изменения свойства. Зависит Отсутствует
VerticallyScrollableProperty событие изменения свойства. Зависит Отсутствует
VerticalViewSizeProperty событие изменения свойства. Зависит Отсутствует
AutomationFocusChangedEvent Обязательно Отсутствует
StructureChangedEvent Обязательно Отсутствует

См. также

  • Last updated on