Menüsteuerelementtyp
Dieses Thema enthält Informationen zu Microsoft Benutzeroberflächenautomatisierung-Unterstützung für den Menü-Steuerelementtyp.
Ein Menüsteuerelement ermöglicht die hierarchische Organisation von Elementen, die Befehlen und Ereignishandlern zugeordnet sind. In einer typischen Microsoft Windows-Anwendung enthält eine Menüleiste mehrere Menüschaltflächen (z. B. Datei , Bearbeiten und Fenster), und jede Menüschaltfläche zeigt ein Menü an. Ein Menü enthält eine Sammlung von Menüelementen (z. B. Neu, Öffnen und Schließen), die erweitert werden können, um weitere Menüelemente anzuzeigen, oder auf die geklickt werden kann, um eine bestimmte Aktion auszuführen.
In den folgenden Abschnitten werden die Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp Menu definiert. Die Benutzeroberflächenautomatisierung gelten für alle Menüsteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
Typische Strukturstruktur
Die folgende Tabelle zeigt ein typisches Steuerelement und eine Inhaltsansicht der Benutzeroberflächenautomatisierung struktur, die sich auf Menüsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur Benutzeroberflächenautomatisierung Struktur finden Sie unter Benutzeroberflächenautomatisierung Strukturübersicht.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Menüsteuerelemente werden immer in der Steuerelementansicht und in der Inhaltsansicht der Benutzeroberflächenautomatisierung angezeigt. Menüsteuerelemente sollten unter dem Steuerelement angezeigt werden, auf das ihre Informationen verweisen. Benutzeroberflächenautomatisierung clients können auf UIA _ MenuOpenedEventId lauschen, um sicherzustellen, dass sie konsistent Informationen abrufen, die von Menüsteuerelementen übermittelt werden. Kontextmenü-Steuerelemente sind ein besonderer Fall. Sie werden möglicherweise als children des Desktops oder eines Anwendungsfensters der obersten Ebene angezeigt.
Ein Menüsteuerelement kann innerhalb seiner Struktur andere Steuerelemente enthalten, z. B. Bearbeitungssteuerelemente und Kombinationsfelder. Diese zusätzlichen Steuerelemente entsprechen den "anderen Steuerelementen", die in der vorherigen Tabelle in den Steuerelement- und Inhaltsansichten aufgeführt sind.
Relevante Eigenschaften
In der folgenden Tabelle sind Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für den Steuerelementtyp "Menu" besonders relevant ist. Weitere Informationen zu Eigenschaften Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA _ ControlTypePropertyId | Menü | |
| UIA _ IsContentElementPropertyId | TRUE | Das Menüsteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung enthalten. |
| UIA _ IsControlElementPropertyId | TRUE | Das Menüsteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung enthalten. |
| UIA _ LabeledByPropertyId | NULL | Für ein typisches Menüsteuerelement wird keine Bezeichnung erwartet. |
| UIA _ NamePropertyId | Siehe Hinweise. | Für das Menüsteuerelement muss keine Name-Eigenschaft festgelegt werden, oder es kann denselben Namen wie das zugeordnete Steuerelement haben, z. B. ein Menüelement, das das Untermenü geöffnet hat. |
Erforderliche Steuerelementmuster
Für den Menu-Steuerelementtyp gibt es keine erforderlichen Steuerelementmuster.
Erforderliche Ereignisse
Menüsteuerelemente müssen das _ UIA-MenuOpenedEventId-Ereignis ausgelöst werden, wenn sie auf dem Bildschirm angezeigt werden. Das UIA _ MenuOpenedEventId-Ereignis enthält den Text des Steuerelements. Das UIA _ MenuClosedEventId-Ereignis muss ausgelöst werden, wenn ein Menü vom Bildschirm verschwindet.
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung aufgeführt, die von Menüsteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Benutzeroberflächenautomatisierung-Ereignis | Notizen |
|---|---|
| UIA _ AutomationFocusChangedEventId | |
| UIA _ BoundingRectanglePropertyId-Eigenschaftsänderungsereignis. | |
| UIA _ IsEnabledPropertyId-Eigenschaftsänderungsereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ IsOffscreenPropertyId-Eigenschaftsänderungsereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| _UIA-MenüClosedEventId | |
| _UIA-MenüOpenedEventId | |
| UIA _ StructureChangedEventId |