Поддержка модели автоматизации пользовательского интерфейса для типа элемента управления меню
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о поддержке Microsoft модель автоматизации пользовательского интерфейса для типа элемента управления Menu. В нем описывается структура дерева microsoft модель автоматизации пользовательского интерфейса элемента управления и предоставляет свойства и шаблоны элементов управления для конкретных сценариев управления.
Элемент управления "Меню" позволяет иерархически организовать элементы, связанные с командами и обработчиками событий. В обычном приложении Microsoft Windows строка меню содержит несколько кнопок меню (например , "Файл", "Изменить" и "Окно"), а каждая кнопка меню отображает меню. Меню содержит набор пунктов меню (таких как Создать, Открытьи Закрыть), которые можно развернуть, чтобы отобразить дополнительные пункты меню или выполнить определенное действие, нажав соответствующий пункт.
В следующих разделах определяется необходимая модель автоматизации пользовательского интерфейса структура дерева, свойства, шаблоны элементов управления и события для типа элемента управления Menu. Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления списками, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице показано представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления меню и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
| Меню — MenuItem (1 или много) |
Неприменимо (если элемент управления "Меню" не является контекстным меню, родительским для объекта, который не является пунктом меню) — MenuItem (1 или много) |
Элементы управления меню всегда отображаются в представлении элемента управления и в представлении содержимого дерева модель автоматизации пользовательского интерфейса. Типы элементов управления Menu должны появляться над элементом управления, к которому относятся их сведения. Клиенты автоматизации пользовательского интерфейса должны прослушивать MenuOpenedEvent , чтобы убедиться, что они постоянно получают сведения, предоставляемые элементами управления "Меню". Особым случаем являются элементы управления "Контекстное меню". Они отображаются как дочерние элементы рабочего стола.
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которого особенно относится к типу элемента управления Menu. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| NameProperty | Не поддерживается | Для элемента управления "Меню" не требуется задание свойства Name. |
| LabeledByProperty | Null |
С обычным элементом управления "Меню" не ожидается никаких меток. |
| ControlTypeProperty | Меню | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| IsContentElementProperty | False | Элемент управления меню не включен в представление содержимого дерева модель автоматизации пользовательского интерфейса. |
| IsControlElementProperty | Истина | Элемент управления меню всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса. |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
Для типа элемента управления Menu отсутствуют обязательные шаблоны элементов управления.
Необходимые события модели автоматизации пользовательского интерфейса
Элементы управления "Меню" должны вызывать событие MenuOpenedEvent при отображении на экране. MenuOpenedEvent будет включать текст элемента управления. При исчезновении меню с экрана должно вызываться событие MenuClosedEvent .
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления меню. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка/значение | Примечания. |
|---|---|---|
| MenuOpenedEvent | Обязательное поле | нет |
| MenuClosedEvent | Обязательное поле | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |