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

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

Замечание

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

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

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

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

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

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

— различные элементы управления (0 или более)		 Панель инструментов

— различные элементы управления (0 или более)

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

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

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

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

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

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

Шаблон элемента управления Поддержка Примечания.
ExpandCollapsePattern Зависит Если панель инструментов может быть развернута и свернута для отображения дополнительных элементов, она должна поддерживать этот шаблон.
DockPattern Зависит Если панель инструментов может быть закреплена на разных частях экрана, она должна поддерживать этот шаблон.
TransformPattern Зависит Если панель инструментов может быть изменена, поворачивается или перемещается, она должна поддерживать этот шаблон.

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

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

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

См. также