Benutzeroberflächenautomatisierungs-Unterstützung für den Menü-Steuerelementtyp

Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

Dieses Thema enthält Informationen über die Microsoft UI Automation-Unterstützung für den Menü-Steuerelementtyp. Es wird die Microsoft UI Automation-Struktur des Steuerelements beschrieben, und die Eigenschaften sowie Steuerelementmuster für bestimmte Steuerelementszenarien werden angegeben.

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 (wie Datei, Bearbeiten und Fenster), und beim Klicken auf eine Menüschaltfläche wird ein Menü angezeigt. Ein Menü enthält eine Sammlung von Menüelementen (z. B. Neu, Öffnen und Schließen). Wenn sie darauf klicken, werden sie erweitert, sodass weitere Menüelemente angezeigt werden oder eine bestimmte Aktion ausgeführt wird.

In den folgenden Abschnitten werden die UI Automation-Struktur, Eigenschaften, Steuerelementmuster und Ereignisse definiert, die für den Menü-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Listen-Steuerelemente, seien dies Windows Presentation Foundation (WPF)-, Win32- oder Windows Forms-Steuerelemente.

Dieses Thema enthält folgende Abschnitte.

• Erforderliche Benutzeroberflächenautomatisierungs-Struktur
• Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
• Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
• Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
• Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur für Menü-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht	Inhaltsansicht
Menü MenuItem (1 oder viele)	Nicht anwendbar (außer wenn das Menü-Steuerelement ein Kontextmenü ist, das ein übergeordnetes Element eines Objekts ist, das kein Menüelement ist) MenuItem (1 oder viele)

Menü-Steuerelemente werden stets in der Steuerelementansicht und der Inhaltsansicht der UI Automation-Struktur angezeigt. Menü-Steuerelementtypen werden unter dem Steuerelement angezeigt, auf das ihre Informationen verweisen. Benutzeroberflächenautomatisierungs-Clients müssen MenuOpenedEvent überwachen, damit sie jederzeit von Menü-Steuerelementen übermittelte Informationen erhalten. Kontextmenü-Steuerelemente sind ein besonderer Fall. Sie werden als untergeordnete Elemente des Desktops angezeigt.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Wert oder Definition für den Menü-Steuerelementtyp besonders relevant ist. Weitere Informationen zu UI Automationseigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-Eigenschaft	Wert	Hinweise
NameProperty	Nicht unterstützt	Für das Menü-Steuerelement muss keine Name-Eigenschaft festgelegt werden.
LabeledByProperty	Null	Bei einem typischen Menü-Steuerelement wird keine Bezeichnung erwartet.
ControlTypeProperty	Menü	Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
IsContentElementProperty	False	Das Menü-Steuerelement ist nicht in der Inhaltsansicht der UI Automation-Struktur enthalten.
IsControlElementProperty	True	Das Menü-Steuerelement ist stets in der Steuerelementansicht der UI Automation-Struktur enthalten.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

Für den Menü-Steuerelementtyp gibt es keine erforderlichen Steuerelementmuster.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

Menü-Steuerelemente müssen MenuOpenedEvent auslösen, wenn sie auf dem Bildschirm angezeigt werden. MenuOpenedEvent enthält den Text des Steuerelements. MenuClosedEvent muss ausgelöst werden, wenn ein Menü auf dem Bildschirm geschlossen wird.

In der folgenden Tabelle werden die UI Automation-Ereignisse aufgelistet, die von allen Menü-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI Automation-Ereignis	Unterstützung/Wert	Hinweise
MenuOpenedEvent	Erforderlich	Keine
MenuClosedEvent	Erforderlich	Keine
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte Eigenschaft ausgelöstes IsEnabledProperty-Ereignis.	Erforderlich	Keine
AutomationFocusChangedEvent	Erforderlich	Keine
StructureChangedEvent	Erforderlich	Keine

Siehe auch

Referenz

Menu

Konzepte

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung