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


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

ПримечаниеПримечание

Эта документация предназначена для разработчиков на платформе .NET Framework, которым требуется использовать управляемые классы UI Automation, определенные в пространстве имен System.Windows.Automation.Последние сведения о UI Automation см. на веб-странице Windows Automation API: UI Automation.

В этом разделе содержатся сведения о поддержке моделью элемента управления типа Microsoft UI Automation Menu. Описывается структура дерева Microsoft UI Automation элемента управления и представлены свойства и шаблоны для скриптов отдельных элементов управления.

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

В следующих разделах описывается требуемая древовидная структура UI Automation, свойства, шаблоны и события для типа элемента управления меню. Требования UI Automation применяются ко всем элементам управления списка , будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.

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

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

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

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

Представление элементов управления

Представление содержимого

Меню

  • MenuItem (1 или несколько)

Неприменимо (если элемент управления Menu не является контекстным меню, представляющим собой родительский элемент объекта, который не является пунктом меню)

  • MenuItem (1 или несколько)

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

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

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

Свойство UI Automation

Значение

Примечания

NameProperty

Не поддерживается

Для элемента управления меню не требуется свойство "Имя".

LabeledByProperty

Null

С типовым элементом управления Menu не ожидается никаких меток.

ControlTypeProperty

Меню

Это значение одинаково для всех структур пользовательского интерфейса.

IsContentElementProperty

False

Элемент управления меню не включен в представление содержимого дерева UI Automation.

IsControlElementProperty

True

Элемент управления меню всегда включен в представление элемента управления дерева UI Automation.

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

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

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

При отображении на экране элементы управления меню должны вызывать событие MenuOpenedEvent. Событие MenuOpenedEvent включает текст элемента управления. Когда меню исчезает с экрана, должно вызываться событие MenuClosedEvent.

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

Событие UI Automation

Поддержка/значение

Примечания

MenuOpenedEvent

Обязательно

Нет

MenuClosedEvent

Обязательно

Нет

Событие, изменяемое свойством BoundingRectangleProperty.

Обязательно

Нет

Событие, изменяемое свойством IsOffscreenProperty.

Требуется

Нет

Событие, изменяемое свойством IsEnabledProperty.

Обязательно

Нет

AutomationFocusChangedEvent

Обязательно

Нет

StructureChangedEvent

Обязательно

Нет

См. также

Ссылки

Menu

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

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

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

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