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

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

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

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

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

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

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

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

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

Элемент управления "Панель инструментов" может содержать элемент управления любого типа в пределах поддерева. Чаще всего он содержит кнопки, поля со списком и разворачивающиеся кнопки (SplitButton).

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

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

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

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

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

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

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

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

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

См. также

Ссылки

ToolBar

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

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

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