MenuBar-Steuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung von Microsoft Benutzeroberflächenautomatisierung für den Steuerelementtyp MenuBar.
Menüleisten-Steuerelemente 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 Benutzeroberflächenframework bzw. 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 jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierung-Struktur finden Sie unter übersicht über Benutzeroberflächenautomatisierung-Struktur.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Ein Menüleisten-Steuerelement wird immer in der Steuerelementansicht, aber nicht in der Inhaltsansicht angezeigt, da es dem Endbenutzer in der Regel 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, kann die gesamte Tastatureingabe für die Menünavigation erfasst werden (z. B. kann die Eingabe von "s" das Menü Speichern aufrufen, anstatt das Zeichen im Anwendungsclientbereich einzugeben). Das UIA _ MenuModeStartEventId-Ereignis muss vor dem ersten UIA _ MenuOpenedEventId-Ereignis stehen, um die logische Konsistenz sicherzustellen. Das UIA _ MenuModeEndEventId-Ereignis folgt auf das letzte UIA _ MenuClosedEventId-Ereignis. Wenn Sie auf ein Menüelement klicken, wird möglicherweise auch sofort das UIA _ MenuModeStartEventId-Ereignis ausgelöst, gefolgt von einem UIA _ MenuOpenedEventId-Ereignis.
Ein Menüleisten-Steuerelement kann andere Steuerelemente, z. B. Bearbeitungssteuerelemente und Kombinationsfelder, in seiner Struktur enthalten. 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 für den MenuBar-Steuerelementtyp besonders 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 Zugriffstasten. |
| UIA _ AccessKeyPropertyId | „ALT“ | Durch Drücken der ALT-TASTE sollte in der Regel der Fokus auf die Menüleiste innerhalb der Anwendung gelegt werden. |
| 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üleisten-Steuerelement ist nicht in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
| UIA _ IsControlElementPropertyId | TRUE | Das Menüleisten-Steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur 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üleisten-Steuerelemente 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 Distinguishing-Namen wie "Formatierung" oder "Gliederung" verfügbar zu machen. |
| 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 Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von Menüleistensteuerelementen 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 Steuerelementmuster Transformieren implementieren. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die von Menüleistensteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Benutzeroberflächenautomatisierung-Ereignis | Notizen |
|---|---|
| UIA _ AutomationFocusChangedEventId | |
| UIA _ Das BoundingRectanglePropertyId-Eigenschaftswechselereignis. | |
| UIA _ Das Eigenschaftswechselereignis ExpandCollapseExpandCollapseStatePropertyId. | Wenn das Steuerelement das ExpandCollapse-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ Das IsEnabledPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ IsOffscreenPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ StructureChangedEventId |