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

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

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

Элементы управления строки меню являются примерами элементов управления, которые реализуют тип элемента управления MenuBar. Строка меню предоставляет пользователям средства активации команд и параметров, содержащихся в приложении.

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

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

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

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

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

Представление элементов управления	Представление содержимого
MenuBar MenuItem (1 или несколько) Другие элементы управления (0 или несколько)	MenuBar MenuItem (1 или несколько) Другие элементы управления (0 или несколько)

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

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

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

Свойство UI Automation	Значение	Примечания
BoundingRectangleProperty	См. примечания.	Значение, представляемое этим свойством, должно включать все элементы управления, содержащихся в нем.
NameProperty	См. примечания.	Элементу управления строки меню требуется имя, если только приложение имеет более одной строки меню. Если в приложении имеется более одной строки меню, то это свойство должно использоваться для предоставления различающихся имен, например, "Форматирование" или "Структура".
LabeledByProperty	Null	У элемента управления строки меню никогда нет подписи.
ControlTypeProperty	MenuBar	Это значение одинаково для всех структур пользовательского интерфейса.
LocalizedControlTypeProperty	"строка меню"	Локализованная строка, соответствующая типу элемента управления MenuBar.
IsContentElementProperty	True	Элемент управления строки меню всегда включается в представление содержимого дерева UI Automation.
IsControlElementProperty	True	Элемент управления строки меню всегда включается в представление элемента управления дерева UI Automation.
IsOffscreenProperty	См. примечания.	Значение этого свойства зависит от того, отображается ли элемент управления на экране.
OrientationProperty	Зависит от конкретного случая	Это свойство отображает, является ли строка меню горизонтальной или вертикальной.
IsKeyboardFocusableProperty	True	Элемент управления строки меню всегда принимает фокус клавиатуры, так как элементы управления, которые он содержит, могут принимать фокус клавиатуры.
HelpTextProperty	См. примечания.	Нет скриптов, в которых элементам управления строки меню требовался бы текст справки.
AcceleratorKeyProperty	Null	Строки меню никогда не имеют клавиш быстрого доступа.
AccessKeyProperty	"ALT"	Нажатие клавиши ALT в приложении должно всегда переводить фокус на строку меню.

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

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

Шаблон элемента управления	Поддержка	Примечания
IExpandCollapseProvider	Зависит от конкретного случая	Если элемент управления может быть развернут или свернут, реализуйте IExpandCollapseProvider.
IDockProvider	Зависит от конкретного случая	Если элемент управления может быть прикреплен к различным частям экрана, реализуйте IDockProvider.
ITransformProvider	Зависит от конкретного случая	Если для элемента управления возможно изменение размеров, поворот или смещение, он должен реализовывать ITransformProvider.

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

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

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

См. также

Ссылки

MenuBar

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

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

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