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

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также