Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Hinweis
Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Windows Automation API: Benutzeroberflächenautomatisierung.
Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den Menüsteuerelementtyp. Es beschreibt die Struktur des Microsoft UI-Automatisierungsbaums des Steuerelements und gibt die Eigenschaften und Steuerungsmuster für spezifische Szenarien bereit.
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 des UI-Automatisierungsbaums, Eigenschaften, Steuerelementmuster und Ereignisse für den Menü-Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Listensteuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms.
Erforderliche UI-Automatisierungsbaumstruktur
Die folgende Tabelle zeigt die Steuerelementansicht und die Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Menüsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungs-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungsstruktur.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| Menü - Menüpunkt (ein oder mehrere) |
Nicht anwendbar (es sei denn, das Menüsteuerelement ist ein Kontextmenü, das ein übergeordnetes Element eines Objekts ist, das kein Menüelement ist) - Menüpunkt (ein oder mehrere) |
Menüsteuerelemente werden immer in der Steuerelementansicht und in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur angezeigt. Menu-Steuerelementtypen sollten unter dem Steuerelement angezeigt werden, auf das ihre Informationen verweisen. Benutzeroberflächenautomatisierungs-Clients müssen auf MenuOpenedEvent achten, um sicherzustellen, dass sie konsistente Informationen erhalten, die von Menüsteuerelementen vermittelt werden. Kontextmenüsteuerelemente sind ein Sonderfall. Sie werden als untergeordnete Elemente des Desktops angezeigt.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungs-Eigenschaften aufgeführt, deren Wert oder Definition besonders für den Menüsteuerelementtyp relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierungs-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungseigenschaften für Clients.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| NameProperty | Nicht unterstützt | Für die Menüsteuerung muss keine Namenseigenschaft festgelegt werden. |
| LabeledByProperty | Null |
Es wird keine Bezeichnung mit einem typischen Menüsteuerelement erwartet. |
| ControlTypeProperty | Menü | Dieser Wert ist für alle Benutzeroberflächenframeworks identisch. |
| IsContentElementProperty | Falsch | Das Menüsteuerelement ist nicht in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| IsControlElementProperty | Richtig | Das Menüsteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
Für den Menüsteuerelementtyp sind keine erforderlichen Steuerelementmuster vorhanden.
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
Menüsteuerelemente müssen MenuOpenedEvent auslösen, wenn sie auf dem Bildschirm angezeigt werden. Der MenuOpenedEvent wird den Text des Steuerelements enthalten. Das MenuClosedEvent Muss ausgelöst werden, wenn ein Menü vom Bildschirm verschwindet.
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die von allen Menüsteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.
| Benutzeroberflächenautomatisierungs-Ereignis | Support/Wert | Hinweise |
|---|---|---|
| MenuOpenedEvent | Erforderlich | Nichts |
| MenuClosedEvent | Erforderlich | Nichts |
| Durch die BoundingRectangleProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die IsOffscreenProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die IsEnabledProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| AutomationFocusChangedEvent | Erforderlich | Nichts |
| StructureChangedEvent | Erforderlich | Nichts |