Freigeben über


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

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
  • MenuBar
    • MenuItem (1 oder mehr)
    • Andere Steuerelemente (0 oder viele)
  • Nicht zutreffend
    • MenuItem (1 oder mehr)
    • Andere Steuerelemente (0 oder viele)

 

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

 

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung