Benutzeroberflächenautomatisierungs-Unterstützung für den Menü-Steuerelementtyp
Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler konzipiert, die die verwalteten Klassen zur Automatisierung der Benutzeroberfläche verwenden möchten, die im Namespace System.Windows.Automation definiert sind. Aktuelle Informationen zur Automatisierung der Benutzeroberfläche finden Sie auf der Seite zur Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.
In diesem Thema erhalten Sie Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den Steuerelementtyp „Menu“. Es werden die Struktur der Benutzeroberflächenautomatisierung für das Steuerelement sowie die Eigenschaften und Steuerelementmuster für bestimmte Steuerelementszenarien beschrieben.
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 erforderliche Struktur der Benutzeroberflächenautomatisierung, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp „Menu“ definiert. Die Anforderungen für die Benutzeroberflächenautomatisierung gelten für alle Listensteuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms verwendet wird.
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung für Menüsteuerelemente sowie die möglichen Inhalte der Ansichten beschrieben. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| Menü – MenuItem (1 oder viele) |
Nicht zutreffend (es sei denn, das Menüsteuerelement ist ein Kontextmenü, das ein übergeordnetes Element eines Objekts ist, die kein Menüelement ist) – MenuItem (1 oder viele) |
Menüsteuerelemente werden immer in der Steuerelementansicht und der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung angezeigt. Menu-Steuerelementtypen sollten unter dem Steuerelement angezeigt werden, auf das ihre Informationen verweisen. Benutzeroberflächenautomatisierungs-Clients müssen MenuOpenedEvent lauschen, damit sichergestellt ist, dass sie durchgängig 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 sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition für den Steuerelementtyp „Menu“ von besonderem Interesse ist. Weitere Informationen zu den Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Eigenschaften der Benutzeroberflächenautomatisierung für Clients.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| NameProperty | Nicht unterstützt | Für das Menüsteuerelement muss keine Name-Eigenschaft festgelegt werden. |
| LabeledByProperty | Null |
Für ein typisches Menüsteuerelement wird keine Bezeichnung erwartet. |
| ControlTypeProperty | Menü | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| IsContentElementProperty | Falsch | Das Menüsteuerelement ist in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung nicht enthalten. |
| IsControlElementProperty | True | Das Menüsteuerelement ist stets in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung enthalten. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
Für den Menu-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 sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen Menüsteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Unterstützung/Wert | Notizen |
|---|---|---|
| MenuOpenedEvent | Erforderlich | Keine |
| MenuClosedEvent | Erforderlich | Keine |
| Durch geänderteBoundingRectangleProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsOffscreenProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsEnabledProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| AutomationFocusChangedEvent | Erforderlich | Keine |
| StructureChangedEvent | Erforderlich | Keine |