MenuBar-Steuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung des MenuBar-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.
Menüleistensteuerelemente sind ein Beispiel für Steuerelemente, die den MenuBar-Steuerelementtyp implementieren. 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 erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den MenuBar-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Menüleistensteuerelemente, bei denen das Ui-Framework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Struktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Menüleistensteuerelemente bezieht, und beschreibt, was in den einzelnen Ansichten enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Ein Menüleistensteuerelement wird immer in der Steuerelementansicht, aber nicht in der Inhaltsansicht angezeigt, da es dem Endbenutzer normalerweise keine aussagekräftigen Informationen übermittelt (es sei denn, die Anwendung enthält mehr als eine Menüleiste).
Benutzeroberflächenautomatisierung Clients können auf das UIA_MenuModeStartEventId-Ereignis lauschen, um sicherzustellen, dass sie konsistent benachrichtigt werden, wenn die Benutzeroberfläche in den Menümodus wechselt. Wenn sich die Anwendung im Menümodus befindet, können alle Tastatureingaben für die Menünavigation erfasst werden (beispielsweise kann die Eingabe von "s" das Menü Speichern aufrufen, anstatt das Zeichen im Anwendungsclientbereich einzugeben). Das UIA_MenuModeStartEventId-Ereignis muss dem ersten UIA_MenuOpenedEventId-Ereignis vorangehen, um die logische Konsistenz sicherzustellen. Das UIA_MenuModeEndEventId-Ereignis folgt dem letzten UIA_MenuClosedEventId-Ereignis . Durch Klicken auf ein Menüelement kann auch sofort das UIA_MenuModeStartEventId-Ereignis ausgelöst werden, gefolgt von einem UIA_MenuOpenedEventId-Ereignis .
Ein Menüleistensteuerelement kann andere Steuerelemente enthalten, z. B. Steuerelemente bearbeiten und Kombinationsfelde, in seiner Struktur. Diese weiteren Steuerelemente sind oben in der Inhalts- und der Steuerelementansicht mit „Andere Steuerelemente“ gemeint.
Relevante Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition besonders für den MenuBar-Steuerelementtyp relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elementen.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA_AcceleratorKeyPropertyId | NULL | Menüleisten verfügen in der Regel nicht über Tastenkombinationen. |
| UIA_AccessKeyPropertyId | „ALT“ | Das Drücken der ALT-Taste sollte in der Regel den Fokus auf die Menüleiste innerhalb der Anwendung bringen. |
| UIA_BoundingRectanglePropertyId | Siehe Hinweise. | Der von dieser Eigenschaft verfügbar gemachte Wert muss sämtliche darin enthaltenen Steuerelemente umfassen. |
| UIA_ControlTypePropertyId | MenuBar | |
| UIA_IsContentElementPropertyId | FALSE | Das Menüleistensteuerelement ist nicht in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
| UIA_IsControlElementPropertyId | TRUE | Das Menüleistensteuerelement ist stets in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung enthalten. |
| UIA_IsKeyboardFocusablePropertyId | TRUE | Menüleisten-Steuerelemente können den Tastaturfokus erhalten, da die in ihnen enthaltenen Steuerelemente den Tastaturfokus übernehmen können. |
| UIA_IsOffscreenPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft ist hängt davon ab, ob das Steuerelement auf dem Bildschirm angezeigt werden kann. |
| UIA_LabeledByPropertyId | NULL | Menüleistensteuerelemente verfügen in der Regel nicht über eine Bezeichnung. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem MenuBar-Steuerelementtyp entspricht. Der Standardwert ist "Menüleiste" für en-US oder Englisch (USA). |
| UIA_NamePropertyId | Siehe Hinweise. | Das Menüleisten-Steuerelement muss nur dann einen Namen haben, wenn eine Anwendung mehrere Menüleisten hat. Wenn in einer Anwendung mehrere Menüleisten vorhanden sind, verwenden Sie diese Eigenschaft, um Unterscheidungsnamen verfügbar zu machen, z. B. "Formatierung" oder "Auslegen". |
| UIA_OrientationPropertyId | Depends (Abhängig) | Diese Eigenschaft gibt an, ob das Menüleisten-Steuerelement horizontal oder vertikal verläuft. |
Erforderliche 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 | Notizen |
|---|---|---|
| IExpandCollapseProvider | Depends (Abhängig) | Wenn das Steuerelement erweitert oder reduziert werden kann, muss es das ExpandCollapse-Steuerelementmuster implementieren. |
| IDockProvider | Depends (Abhängig) | Wenn das Steuerelement an verschiedene Teile des Bildschirms angedockt werden kann, muss es das Dock-Steuerelementmuster implementieren. |
| ITransformProvider | Depends (Abhängig) | Wenn die Größe des Steuerelements geändert, gedreht oder verschoben werden kann, muss es das Transformationssteuerelementmuster implementieren. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Menüleistensteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Notizen |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis. | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement das ExpandCollapse-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_StructureChangedEventId |
Zugehörige Themen