Тип элемента управления меню
В этом разделе содержатся сведения о поддержке службы автоматизации пользовательского интерфейса Майкрософт для типа элемента управления меню.
Элемент управления меню позволяет иерархической организации элементов, связанных с командами и обработчиками событий. В обычном приложении Microsoft Windows строка меню содержит несколько кнопок меню (например, файл, изменениеи окно), а каждая кнопка меню отображает меню. Меню содержит коллекцию элементов меню (например, Создать, Открытьи Закрыть), которые можно развернуть для отображения дополнительных элементов меню или выполнения определенного действия при щелчке.
В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления Меню. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления меню, где платформа и платформа пользовательского интерфейса интегрирует поддержку автоматизации пользовательского интерфейса для типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие разделы.
- типичная структура дерева
- соответствующие свойства
- обязательные шаблоны элементов управления
- обязательные события
- связанные разделы
Типичная структура дерева
В следующей таблице представлено типичное представление элемента управления и содержимого дерева автоматизации пользовательского интерфейса, относящегося к элементам управления меню и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве автоматизации пользовательского интерфейса см. в обзоре дерева автоматизации пользовательского интерфейса.
Представление элемента управления | Представление содержимого |
---|---|
|
|
Элементы управления меню всегда отображаются в представлении элемента управления и в представлении содержимого дерева автоматизации пользовательского интерфейса. Элементы управления меню должны отображаться под элементом управления, к которому ссылается их информация. Клиенты автоматизации пользовательского интерфейса могут прослушивать UIA_MenuOpenedEventId, чтобы обеспечить согласованное получение информации, передаваемой элементами управления меню. Элементы управления контекстным меню — это особый случай. Они могут отображаться как дочерние элементы рабочего стола или окна приложения верхнего уровня.
Элемент управления меню может содержать другие элементы управления, такие как элементы управления редактирования и поля со списком в его структуре. Эти дополнительные элементы управления соответствуют "другим элементам управления", перечисленным в предыдущей таблице в представлениях элементов управления и содержимого.
Соответствующие свойства
В следующей таблице перечислены свойства автоматизации пользовательского интерфейса, значение или определение которых особенно важно для типа элемента управления Меню. Дополнительные сведения о свойствах автоматизации пользовательского интерфейса см. в получения свойств из элементов автоматизации пользовательского интерфейса.
Свойство автоматизации пользовательского интерфейса | Ценность | Примечания |
---|---|---|
UIA_ControlTypePropertyId | меню | |
UIA_IsContentElementPropertyId | ИСТИННЫЙ | Элемент управления меню всегда включается в представление содержимого дерева автоматизации пользовательского интерфейса. |
UIA_IsControlElementPropertyId | ИСТИННЫЙ | Элемент управления меню всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса. |
UIA_LabeledByPropertyId | НЕДЕЙСТВИТЕЛЬНЫЙ | Метка не ожидается с помощью типичного элемента управления меню. |
UIA_NamePropertyId | См. заметки. | Элемент управления меню не требует задания свойства Name или может иметь то же имя, что и связанный элемент управления, например элемент меню, открывший подменю. |
Обязательные шаблоны элементов управления
Для типа элемента управления Menu отсутствуют обязательные шаблоны элементов управления.
Обязательные события
Элементы управления меню должны вызывать событие UIA_MenuOpenedEventId при отображении на экране. Событие UIA_MenuOpenedEventId будет содержать текст элемента управления. Событие UIA_MenuClosedEventId должно возникать при исчезновении меню с экрана.
В следующей таблице перечислены события автоматизации пользовательского интерфейса, необходимые для поддержки элементов управления меню. Дополнительные сведения о событиях см. в обзоре событий автоматизации пользовательского интерфейса.
Событие автоматизации пользовательского интерфейса | Примечания |
---|---|
UIA_AutomationFocusChangedEventId | |
событие UIA_BoundingRectanglePropertyId изменено свойством. | |
событие UIA_IsEnabledPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие. |
событие UIA_IsOffscreenPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие. |
UIA_MenuClosedEventId | |
UIA_MenuOpenedEventId | |
UIA_StructureChangedEventId |
Связанные разделы
-
концептуальные
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса