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


Тип элемента управления меню

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

Элемент управления меню позволяет иерархической организации элементов, связанных с командами и обработчиками событий. В обычном приложении Microsoft Windows строка меню содержит несколько кнопок меню (например, файл, изменениеи окно), а каждая кнопка меню отображает меню. Меню содержит коллекцию элементов меню (например, Создать, Открытьи Закрыть), которые можно развернуть для отображения дополнительных элементов меню или выполнения определенного действия при щелчке.

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

В этом разделе содержатся следующие разделы.

Типичная структура дерева

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

Представление элемента управления Представление содержимого
  • Меню
    • MenuItem (1 или много)
    • Другие элементы управления (0 или многие)
  • Меню
    • MenuItem (1 или много)
    • Другие элементы управления (0 или многие)

 

Элементы управления меню всегда отображаются в представлении элемента управления и в представлении содержимого дерева автоматизации пользовательского интерфейса. Элементы управления меню должны отображаться под элементом управления, к которому ссылается их информация. Клиенты автоматизации пользовательского интерфейса могут прослушивать 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

 

концептуальные

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

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