Benutzeroberflächenautomatisierungs-Unterstützung für den MenuBar-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.
Dieser Artikel enthält Informationen zur Unterstützung der Benutzeroberflächenautomatisierung für den Steuerelementtyp MenuBar. Bei der Benutzeroberflächenautomatisierung entspricht ein Steuerelementtyp einer Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty-Eigenschaft verwendet zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Struktur der Benutzeroberflächenautomatisierung, Eigenschaftswerte der Benutzeroberflächenautomatisierung und Steuerelementmuster.
Ein Beispiel für Steuerelemente, die den MenuBar-Steuerelementtyp implementieren, sind Menüleisten-Steuerelemente. Menüleisten geben dem Benutzer die Möglichkeit, Befehle und Optionen zu aktivieren, die in einer Anwendung enthalten sind.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierung, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp „MenuBar“ 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 Steuerelemente der Menüleiste 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 |
|---|---|
| MenuBar - MenuItem (1 oder mehr) - Andere Steuerelemente (0 oder viele) |
MenuBar - MenuItem (1 oder mehr) - Andere Steuerelemente (0 oder viele) |
Menüleisten-Steuerelemente können in ihrer Struktur andere Steuerelemente enthalten (z. B. Bearbeitungssteuerelemente und Kombinationsfelder). Diese weiteren Steuerelemente sind oben in der Inhalts- und der Steuerelementansicht mit „Andere Steuerelemente“ gemeint.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
Die folgende Tabelle enthält die Benutzeroberflächenautomatisierungs-Eigenschaften, deren Werte oder Definitionen für Steuerelemente der Menüleiste besonders relevant sind. Weitere Informationen zu den Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Eigenschaften der Benutzeroberflächenautomatisierung für Clients.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| BoundingRectangleProperty | Siehe Hinweise. | Der von dieser Eigenschaft verfügbar gemachte Wert muss sämtliche darin enthaltenen Steuerelemente umfassen. |
| NameProperty | Siehe Hinweise. | Das Menüleisten-Steuerelement muss nur dann einen Namen haben, wenn eine Anwendung mehrere Menüleisten hat. Hat eine Anwendung mehrere Menüleisten, sollte diese Eigenschaft dazu verwendet werden, gut zu unterscheidende Namen verfügbar zu machen (etwa „Formatierung“ oder „Gliederung“). |
| LabeledByProperty | Null |
Menüleisten-Steuerelemente haben niemals eine Bezeichnung. |
| ControlTypeProperty | MenuBar | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| LocalizedControlTypeProperty | „Menüleiste“ | Lokalisierte Zeichenfolge für den Steuerelementtyp „MenuBar“. |
| IsContentElementProperty | True | Das Menüleistensteuerelement ist stets in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung enthalten. |
| IsControlElementProperty | True | Das Menüleistensteuerelement ist stets in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung enthalten. |
| IsOffscreenProperty | Siehe Hinweise. | Der Wert dieser Eigenschaft ist hängt davon ab, ob das Steuerelement auf dem Bildschirm angezeigt werden kann. |
| OrientationProperty | Depends (Abhängig) | Diese Eigenschaft gibt an, ob das Menüleisten-Steuerelement horizontal oder vertikal verläuft. |
| IsKeyboardFocusableProperty | True | Menüleisten-Steuerelemente können den Tastaturfokus erhalten, da die in ihnen enthaltenen Steuerelemente den Tastaturfokus übernehmen können. |
| HelpTextProperty | Siehe Hinweise. | Keine Szenarios dafür, wann Hilfetext für ein Menüleisten-Steuerelement erforderlich ist. |
| AcceleratorKeyProperty | Null |
Menüleisten haben niemals Tastenkombinationen. |
| AccessKeyProperty | „ALT“ | Ein Drücken der ALT-TASTE sollte immer bewirken, dass die Menüleiste den Fokus in der Anwendung erhält. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von Steuerelementen der Menüleiste unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster | Support | Hinweise |
|---|---|---|
| IExpandCollapseProvider | Depends (Abhängig) | Wenn das Steuerelement erweitert oder reduziert werden kann, implementieren Sie IExpandCollapseProvider. |
| IDockProvider | Depends (Abhängig) | Wenn das Steuerelement an verschiedenen Teilen des Bildschirms angedockt werden kann, implementieren Sie IDockProvider. |
| ITransformProvider | Depends (Abhängig) | Wenn das Steuerelement gedreht, verschoben oder in der Größe geändert werden kann, muss es ITransformProviderimplementieren. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen Steuerelementen der Menüleiste unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Unterstützung/Wert | Hinweise |
|---|---|---|
| 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 |
| Durch geänderteExpandCollapseStateProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| AutomationFocusChangedEvent | Erforderlich | Keine |
| StructureChangedEvent | Erforderlich | Keine |