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

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

  • Статья

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

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

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

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

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

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

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

 

Элементы управления меню всегда отображаются в представлении элементов управления и в представлении содержимого дерева модель автоматизации пользовательского интерфейса. Элементы управления меню должны находиться под элементом управления, на который ссылается их информация. модель автоматизации пользовательского интерфейса клиенты могут прослушивать UIA_MenuOpenedEventId, чтобы обеспечить согласованное получение сведений, передаваемых элементами управления меню. Особым случаем являются элементы управления "Контекстное меню". Они могут отображаться как дочерние элементы рабочего стола или окна приложения верхнего уровня.

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

Релевантные свойства

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

Свойство модели автоматизации пользовательского интерфейса Значение Примечания
UIA_ControlTypePropertyId Menu
UIA_IsContentElementPropertyId TRUE Элемент управления меню всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса.
UIA_IsControlElementPropertyId TRUE Элемент управления меню всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса.
UIA_LabeledByPropertyId NULL С обычным элементом управления "Меню" не ожидается никаких меток.
UIA_NamePropertyId См. примечания. Для элемента управления меню не требуется задавать свойство Name или он может иметь то же имя, что и связанный элемент управления, например пункт меню, открывший подменю.

 

Обязательные шаблоны элементов управления

Для типа элемента управления Menu отсутствуют обязательные шаблоны элементов управления.

Обязательные события

Элементы управления меню должны вызывать событие UIA_MenuOpenedEventId при появлении на экране. Событие UIA_MenuOpenedEventId будет включать текст элемента управления . Событие UIA_MenuClosedEventId должно вызываться при исчезновении меню с экрана.

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

Событие модель автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId событие изменения свойства.
UIA_IsEnabledPropertyId событие изменения свойства. Если элемент управления поддерживает свойство IsEnabled , он должен поддерживать это событие.
UIA_IsOffscreenPropertyId событие изменения свойства. Если элемент управления поддерживает свойство IsOffscreen , он должен поддерживать это событие.
UIA_MenuClosedEventId
UIA_MenuOpenedEventId
UIA_StructureChangedEventId

 

Основные понятия

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

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