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

Artikel
08/10/2011

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 MenuItem-Steuerelementtyp. Die Microsoft UI Automation-Struktur des Steuerelements wird beschrieben und die Eigenschaften und Steuerelementmuster werden erläutert, die für den MenuItem-Steuerelementtyp erforderlich sind.

Ein Menu-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üelemente (z. B. Datei, Bearbeiten und Fenster), von denen jeweils ein Menü angezeigt wird. Ein Menü enthält eine Auflistung von Menüelementen (z. B. Neu, Öffnen und Schließen), die zum Anzeigen weiterer Menüelemente erweitert werden können bzw. nach einem Klick bestimmte Aktionen ausführen. Ein Menüelement kann in einem Menü, in einer Menüleiste oder in einer Symbolleiste gehostet werden.

In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den MenuItem-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Listensteuerelemente, 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
Benutzeroberflächen-Automatisierungsereignisse für ein Menüelement
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
Legacyprobleme
Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur, die sich auf MenuItem-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht	Inhaltsansicht
MenuItem "Hilfe" Menu (Untermenü eines Hilfemenüelements) MenuItem "Hilfethemen" MenuItem "Info über Editor"	MenuItem "Hilfe" MenuItem "Hilfethemen" MenuItem "Info über Editor"

MenuItem "Hilfe"

Menu (Untermenü eines Hilfemenüelements)
- MenuItem "Hilfethemen"
- MenuItem "Info über Editor"

MenuItem "Hilfe"

MenuItem "Hilfethemen"
MenuItem "Info über Editor"

Die Steuerelementansicht des MenuItem-Steuerelements verfügt über die oben dargestellte UI Automation-Struktur. Das Menüelement Hilfe ist enthalten, um die Struktur in einem typischen Menü in einer Untermenühierarchie besser darzustellen.

In der Inhaltsansicht ist kein Menü in der UI Automation-Struktur vorhanden, da für den Endbenutzer keine sinnvollen Informationen vermittelt werden.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Werte oder Definitionen für die MenuItem-Steuerelemente besonders wichtig sind. Weitere Informationen zu UI Automationseigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

Eigenschaft	Wert	Beschreibung
AutomationIdProperty	Siehe Hinweise.	Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein.
BoundingRectangleProperty	Siehe Hinweise.	Das äußere Rechteck, welches das gesamte Steuerelement umfasst.
ClickablePointProperty	Siehe Hinweise.	Unterstützt, wenn ein umschließendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umschließenden Rechtecks durch Klicken aktiviert werden kann und Sie eine spezielle Trefferprüfung ausführen, setzen Sie diese Eigenschaft außer Kraft, und geben Sie einen durch Klicken aktivierbaren Punkt an.
IsKeyboardFocusableProperty	Siehe Hinweise.	Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
NameProperty	Siehe Hinweise.	Das MenuItem-Steuerelement ist in der Inhaltsansicht der UI Automation-Struktur enthalten und mit einem selbstbezeichnenden Namen versehen.
LabeledByProperty	Null	Keine Bezeichnung.
ControlTypeProperty	MenuItem	Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
LocalizedControlTypeProperty	"Menüelement"	Lokalisierte Zeichenfolge, die dem MenuItem-Steuerelementtyp entspricht.
IsContentElementProperty	True	Das MenuItem-Steuerelement ist nicht in der Inhaltsansicht der UI Automation-Struktur enthalten.
IsControlElementProperty	True	Das MenuItem-Steuerelement muss immer in der Steuerelementansicht der UI Automation-Struktur enthalten sein.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle sind die UI Automation-Steuerelementmuster aufgelistet, die von allen MenuItem-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmustereigenschaft	Unterstützung	Hinweise
IExpandCollapseProvider	Variabel	Wenn das Steuerelement erweitert oder reduziert werden kann, implementieren Sie IExpandCollapseProvider.
IInvokeProvider	Variabel	Wenn vom Steuerelement eine einzelne Aktion oder ein Befehl ausgeführt wird, implementieren Sie IInvokeProvider.
IToggleProvider	Variabel	Wenn das Steuerelement eine Option darstellt, die aktiviert oder deaktiviert werden kann, implementieren Sie IToggleProvider.
ISelectionItemProvider	Variabel	Wenn das Steuerelement verwendet wird, um Menüelemente aus einer Optionenliste auszuwählen, implementieren Sie ISelectionItemProvider.

Benutzeroberflächen-Automatisierungsereignisse für ein Menüelement

In der folgenden Tabelle sind die dem MenuItem-Steuerelement zugeordneten Microsoft UI Automation-Ereignisse aufgelistet.

Ereignis	Unterstützung	Erklärung
InvokedEvent	Variabel	Muss ausgelöst werden, wenn vom Steuerelement das Invoke-Steuerelementmuster unterstützt wird.
Durch geänderte ToggleStateProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Muss ausgelöst werden, wenn vom Steuerelement das Toggle-Steuerelementmuster unterstützt wird.
Durch geänderte ExpandCollapseStateProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Muss ausgelöst werden, wenn vom Steuerelement das ExpandCollapse-Steuerelementmuster unterstützt wird.
ElementSelectedEvent	Variabel	Keine.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle sind die UI Automation-Ereignisse aufgelistet, die von allen MenuItem-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
InvokedEvent	Variabel	Keine
ElementAddedToSelectionEvent	Variabel	Keine
ElementRemovedFromSelectionEvent	Variabel	Keine
ElementSelectedEvent	Variabel	Keine
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte ExpandCollapseStateProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte ToggleStateProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
AutomationFocusChangedEvent	Erforderlich	Keine
StructureChangedEvent	Erforderlich	Keine

Legacyprobleme

Das Toggle-Muster wird nur unterstützt, wenn das Win32-Menüelement aktiviert ist und programmgesteuert festgelegt werden kann, dass Toggle-Muster unterstützt werden. Da vom Win32-Menüelement nicht angezeigt wird, ob es aktiviert werden kann, werden Invoke-Muster unterstützt, wenn das Menüelement nicht aktiviert ist. Ausnahmsweise werden Invoke-Muster dann auch von Menüelementen unterstützt, von denen nur Toggle-Muster unterstützt werden sollten. Von Clients sollte beachtet werden, dass ein Invoke-Muster von einem Element möglicherweise unterstützt wird, solange es deaktiviert ist, dieses Muster jedoch nicht mehr unterstützt wird, wenn das Element aktiviert wird.