Тип элемента управления MenuBar
В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления MenuBar.
Элементы управления в строке меню — это пример элементов управления, реализующих тип элемента управления MenuBar . С помощью строк меню пользователи могут активировать команды и параметры, содержащиеся в приложении.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса древовидной структуры, свойств, шаблонов элементов управления и событий для типа элемента управления MenuBar. Требования к модель автоматизации пользовательского интерфейса применяются ко всем элементам управления в строке меню, где платформа или платформа пользовательского интерфейса интегрируются модель автоматизации пользовательского интерфейса поддержку типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие подразделы.
- Типичная древовидная структура
- Соответствующие свойства
- Обязательные шаблоны элементов управления
- Обязательные события
- Связанные темы
Типичная древовидная структура
В следующей таблице представлен типичный элемент управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления в строке меню, и описывается, что может содержаться в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в разделе Общие сведения о дереве модель автоматизации пользовательского интерфейса.
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Элемент управления "Строка меню" всегда отображается в представлении элемента управления, но не в представлении содержимого, так как он обычно не передает пользователю значимые сведения (если приложение не содержит более одной строки меню).
модель автоматизации пользовательского интерфейса клиенты могут прослушивать событие UIA_MenuModeStartEventId, чтобы гарантировать, что они будут постоянно получать уведомления при переходе пользовательского интерфейса в режим меню. Когда приложение находится в режиме меню, все входные данные с клавиатуры могут быть записаны для навигации по меню (например, при вводе "s" можно вызвать меню Сохранить вместо ввода символа в клиентской области приложения). Событие UIA_MenuModeStartEventId должно предшествовать первому событию UIA_MenuOpenedEventId для обеспечения логической согласованности. Событие UIA_MenuModeEndEventId следует за последним событием UIA_MenuClosedEventId . Щелкнув пункт меню, можно также сразу же активировать событие UIA_MenuModeStartEventId , за которым следует событие UIA_MenuOpenedEventId .
Элемент управления "Строка меню" может содержать другие элементы управления, такие как элементы управления редактирования и поля со списком, в своей структуре. Эти дополнительные элементы управления соответствуют "другим элементам управления", перечисленным выше в представлениях элемента управления и содержимого.
Соответствующие свойства
В следующей таблице перечислены модель автоматизации пользовательского интерфейса свойства, значение или определение которых особенно относится к типу элемента управления MenuBar. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе Извлечение свойств из элементов модель автоматизации пользовательского интерфейса.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания |
|---|---|---|
| UIA_AcceleratorKeyPropertyId | NULL | В строках меню обычно нет клавиш ускорителя. |
| UIA_AccessKeyPropertyId | ALT | Нажатие клавиши ALT обычно приводит к выводу фокуса на строку меню в приложении. |
| UIA_BoundingRectanglePropertyId | См. примечания. | Значение, представляемое этим свойством, должно включать все содержащиеся в нем элементы управления. |
| UIA_ControlTypePropertyId | MenuBar | |
| UIA_IsContentElementPropertyId | Ложь. | Элемент управления "Строка меню" не включен в представление содержимого дерева модель автоматизации пользовательского интерфейса. |
| UIA_IsControlElementPropertyId | TRUE | Элемент управления строка меню всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса. |
| UIA_IsKeyboardFocusablePropertyId | TRUE | Элементы управления "Строка меню" являются фокусируемыми с помощью клавиатуры, так как элементы управления, содержащиеся в них, могут принимать фокус клавиатуры. |
| UIA_IsOffscreenPropertyId | См. примечания. | Значение этого свойства зависит от того, можно ли видеть элемент управления на экране. |
| UIA_LabeledByPropertyId | NULL | Элементы управления в строке меню обычно не имеют метки. |
| UIA_LocalizedControlTypePropertyId | См. примечания. | Локализованная строка, соответствующая типу элемента управления MenuBar . Значение по умолчанию — "строка меню" для en-US или english (США). |
| UIA_NamePropertyId | См. примечания. | Элементу управления "Строка меню" имя не требуется, кроме случая, когда в приложении имеется несколько строк меню. Если в приложении несколько строк меню, используйте это свойство для предоставления различающихся имен, таких как "Форматирование" или "Структурирование". |
| UIA_OrientationPropertyId | Зависит | Это свойство показывает, является ли элемент управления "Строка меню" горизонтальным или вертикальным. |
Обязательные шаблоны элементов управления
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться элементами управления в строке меню. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления | Поддержка | Примечания |
|---|---|---|
| IExpandCollapseProvider | Зависит | Если элемент управления можно развернуть или свернуть, он должен реализовать шаблон элемента управления ExpandCollapse . |
| IDockProvider | Зависит | Если элемент управления можно закрепить на разных частях экрана, он должен реализовать шаблон элемента управления Dock . |
| ITransformProvider | Зависит | Если элемент управления можно изменить, повернуть или переместить, он должен реализовать шаблон элемента управления Преобразование . |
Обязательные события
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые требуются для поддержки элементов управления в строке меню. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| Событие модель автоматизации пользовательского интерфейса | Примечания |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId событие изменения свойства. | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId событие изменения свойства. | Если элемент управления поддерживает шаблон элемента управления ExpandCollapse , он должен поддерживать это событие. |
| UIA_IsEnabledPropertyId событие изменения свойства. | Если элемент управления поддерживает свойство IsEnabled , он должен поддерживать это событие. |
| UIA_IsOffscreenPropertyId событие изменения свойства. | Если элемент управления поддерживает свойство IsOffscreen , он должен поддерживать это событие. |
| UIA_StructureChangedEventId |
Связанные темы
-
Основные понятия
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса
-
Общие сведения о модели автоматизации пользовательского интерфейса
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по