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

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

Замечание

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

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

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

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

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

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

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

— MenuItem (1 или более)
— другие элементы управления (0 или многие)		 Панель меню

— MenuItem (1 или более)
— другие элементы управления (0 или многие)

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

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

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

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

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

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

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

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

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

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

См. также