Menüsteuerelementtyp

Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung 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-, Bearbeitenund Fenster-), und jede Menüschaltfläche zeigt ein Menü an. Ein Menü enthält eine Sammlung von Menüelementen (z. B. Neue, Öffnenund Schließen), die erweitert werden kann, um zusätzliche Menüelemente anzuzeigen oder eine bestimmte Aktion auszuführen, wenn darauf geklickt wird.

In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Menü- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Menüsteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungsunterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält die folgenden Abschnitte.

• typische Strukturstruktur
• Relevante Eigenschaften
• Erforderliche Steuerelementmuster
• Erforderliche Ereignisse
• Verwandte Themen

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Menüsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Menüsteuerelemente werden immer in der Steuerelementansicht und in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur angezeigt. Menüsteuerelemente sollten unter dem Steuerelement angezeigt werden, auf das ihre Informationen verweisen. Benutzeroberflächenautomatisierungs-Clients können auf UIA_MenuOpenedEventId lauschen, um sicherzustellen, dass sie konsistente Informationen erhalten, die von Menüsteuerelementen vermittelt werden. Kontextmenüsteuerelemente sind ein Sonderfall. 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 Kombinationsfelder, innerhalb seiner Struktur. 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 die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für den Menü- Steuerelementtyp relevant ist. Weitere Informationen zu Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.

Erforderliche Steuerelementmuster

Für den Menüsteuerelementtyp sind keine erforderlichen Steuerelementmuster vorhanden.

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 Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die Menüsteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.

Verwandte Themen

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung