Menüsteuerelementtyp
Dieses Thema enthält Informationen zur 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 verschiedene Menüschaltflächen (etwa Datei, Bearbeiten und Fenster), und nach dem Klicken auf eine Menüschaltfläche wird ein Menü angezeigt. Ein Menü enthält eine Sammlung von Menüelementen (z. B. Neu, Öffnenund 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 erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Menu-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Menüsteuerelemente, bei denen das Ui-Framework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Struktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Menüsteuerelemente bezieht, und beschreibt, was in den einzelnen Ansichten enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Menüsteuerelemente werden immer in der Steuerelementansicht und der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung angezeigt. Menüsteuerelemente sollten unter dem Steuerelement angezeigt werden, auf das sich ihre Informationen beziehen. Benutzeroberflächenautomatisierung Clients können auf UIA_MenuOpenedEventId lauschen, um sicherzustellen, dass sie konsistent Informationen erhalten, die von Menüsteuerelementen übermittelt werden. Kontextmenü-Steuerelemente sind ein besonderer Fall. Sie können als untergeordnete Elemente des Desktops oder eines Anwendungsfensters der obersten Ebene angezeigt werden.
Ein Menüsteuerelement kann andere Steuerelemente enthalten, z. B. Bearbeitungssteuerelemente und Kombinationsfelde, in seiner Struktur. Diese zusätzlichen Steuerelemente entsprechen den "anderen Steuerelementen", die in der vorherigen Tabelle in der Steuerelement- und Inhaltsansicht aufgeführt sind.
Relevante Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition besonders für den Menu-Steuerelementtyp relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elementen.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA_ControlTypePropertyId | Menü | |
| UIA_IsContentElementPropertyId | TRUE | Das Menüsteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
| UIA_IsControlElementPropertyId | TRUE | Das Menüsteuerelement ist stets in der Steuerelementansicht der Struktur 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 auslösen, 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 Ereignisse aufgeführt, die Menüsteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Notizen |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis. | |
| UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_MenuClosedEventId | |
| UIA_MenuOpenedEventId | |
| UIA_StructureChangedEventId |
Zugehörige Themen