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

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

Этот раздел содержит сведения о поддержке UI Automation  типа элемента управления TreeItem. В UI Automation тип элемента управления представляет собой набор условий, которым элемент управления должен удовлетворять, чтобы использовать свойство ControlTypeProperty. К этим условиям относятся конкретные правила для древовидной структуры UI Automation, значений свойств UI Automation и шаблонов элементов управления.

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

Следующие разделы определяют необходимую древовидную структуру UI Automation, свойства, шаблоны управления и события для типа элемента управления TreeItem. Требования UI Automation применяются ко всем элементам управления TreeItem, независимо от Windows Presentation Foundation (WPF), Win32 или Windows Forms.

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

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

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

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

Представление элементов управления	Представление содержимого
TreeItem CheckBox (0 или 1) Рисунок (0 или 1) Кнопка (0 или 1) TreeItem (0 или несколько)	TreeItem TreeItem (0 или несколько)

Элементы управления TreeItem могут иметь ноль или несколько дочерних TreeItem в представлении содержимого дерева UI Automation. Если элемент управления TreeItem имеет дополнительные функциональные возможности, которые представлены в перечисленных ниже шаблонах элементов управления, то элемент управления должен основываться на типе элемента управления Data Item.

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

Представление элемента управления может содержать дополнительные сведения в отношении элемента управления, включая связанное изображение или кнопку. Например, элемент в представлении структуры может содержать изображение, а также кнопку для развертывания или свертывания структуры. В представлении содержимого эти объекты сведений не отображаются, поскольку данная информация уже представляется родительским элементом дерева. Элементы TreeItem, перемещаемые путем прокрутки за пределы экрана, появляются в элементе управления и видах содержимого дерева UI Automation и должны установить значение IsOffscreenProperty в true.

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

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

Свойство UI Automation	Значение	Примечания
AutomationIdProperty	См. примечания.	Значение этого свойства должно быть уникальным для каждого элемента управления в приложении.
BoundingRectangleProperty	См. примечания.	Внешний прямоугольник, содержащий весь элемент управления.
ClickablePointProperty	См. примечания.	Это свойство должно возвращать положение элемента, которое приведет к изменению состояния выделения или к получению фокуса.
ControlTypeProperty	TreeItem	Это значение одинаково для всех структур пользовательского интерфейса.
IsContentElementProperty	True	Элемент управления "список" всегда включается в представление элементов управления дерева UI Automation.
IsControlElementProperty	True	Элемент управления "Список" всегда включается в представление элементов управления дерева UI Automation.
IsOffscreenProperty	См. примечания.	Это свойство установлено, чтобы показать, когда элемент управления TreeItem перемещается путем прокрутки за пределы экрана.
IsKeyboardFocusableProperty	См. примечания.	Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство.
ItemTypeProperty	См. примечания.	Если элемент управления TreeItem использует визуальный значок для отображения, который является отдельным типом объекта, тогда это свойство должно поддерживаться и должно указывать, что это за объект.
LabeledByProperty	Null	Элементы управления TreeItem являются самомаркируемыми.
LocalizedControlTypeProperty	"tree item"	Локализованная строка, соответствующая типу элемента управления TreeItem.
NameProperty	См. примечания.	Это свойство предоставляет текст, отображаемый для каждого элемента управления TreeItem.

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

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

Шаблон элемента управления/свойство шаблона	Поддержка / значение	Примечания
IInvokeProvider	Зависит от конкретного случая	Реализуйте этот шаблон элемента управления, если элемент дерева имеет отдельную выполняющуюся команду.
IExpandCollapseProvider	Да	Все элементы дерева могут быть развернуты или свернуты.
ExpandCollapseState	Развернутый, свернутый или конечный узел	Элементы дерева будут листьями дерева, когда они не развернуты или свернуты.
IScrollItemProvider	Зависит от конкретного случая	Реализуйте этот шаблон элемента управления, если контейнер дерева поддерживает шаблон элемента управления прокрутки.
ISelectionItemProvider	Зависит от конкретного случая	Реализуйте этот шаблон элемента управления, если возможно активное выделение, которое сохраняется, когда пользователь возвращается к контейнеру дерева.
SelectionContainer	Да	Это свойство будет предоставлять тот же контейнер для всех элементов внутри контейнера.
IToggleProvider	Зависит от конкретного случая	Реализуйте этот шаблон элемента управления, если элемент управления дерева имеет связанный флажок.

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

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

Событие UI Automation	Поддержка	Примечания
AutomationFocusChangedEvent	Обязательно	Нет
Событие, изменяемое свойством BoundingRectangleProperty.	Обязательно	Нет
Событие, изменяемое свойством IsEnabledProperty.	Требуется	Нет
Событие, изменяемое свойством IsOffscreenProperty.	Требуется	Нет
Событие, изменяемое свойством ItemStatusProperty.	Зависит от конкретного случая	Нет
Событие, изменяемое свойством NameProperty.	Обязательно	Нет
StructureChangedEvent	Обязательно	Нет
Событие, изменяемое свойством ExpandCollapseStateProperty.	Обязательно	Нет
InvokedEvent	Зависит от конкретного случая	Нет
Событие, изменяемое свойством CurrentViewProperty.	Зависит от конкретного случая	Нет
ElementAddedToSelectionEvent	Зависит от конкретного случая	Нет
ElementRemovedFromSelectionEvent	Зависит от конкретного случая	Нет
ElementSelectedEvent	Зависит от конкретного случая	Нет
Событие, изменяемое свойством ToggleStateProperty.	Зависит от конкретного случая	Нет
Событие, изменяемое свойством ValueProperty.	Зависит от конкретного случая	Нет

См. также

Ссылки

TreeItem

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

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

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