Поддержка автоматизации пользовательского интерфейса для типа элемента управления 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 | Обязательное поле | нет |