Freigeben über


Benutzeroberflächenautomatisierungs-Unterstützung für den MenuBar-Steuerelementtyp

HinweisHinweis

Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

Dieses Thema enthält Informationen über die UI Automation-Unterstützung für den MenuBar Steuerelementtyp. In UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.

Ein Beispiel für Steuerelemente, die den MenuBar-Steuerelementtyp implementieren, sind MenuBar-Steuerelemente Menüleisten geben dem Benutzer die Möglichkeit, die Befehle und Optionen einer Anwendung zu aktivieren.

In den folgenden Abschnitten sind die erforderliche UI Automation-Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den MenuBar-Steuerelementtyp definiert. Die UI Automation-Anforderungen gelten für alle Listensteuerelemente, d. h. für Steuerelemente der Typen Windows Presentation Foundation (WPF), Win32 und Windows Forms.

Dieses Thema enthält folgende Abschnitte.

  • Erforderliche Benutzeroberflächenautomatisierungs-Struktur
  • Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
  • Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
  • Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
  • Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur, die sich auf MenuBar-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht

Inhaltsansicht

MenuBar

  • MenuItem (1 oder mehr)

  • Andere Steuerelemente (0 oder mehrere)

MenuBar

  • MenuItem (1 oder mehr)

  • Andere Steuerelemente (0 oder mehrere)

MenuBar-Steuerelemente können innerhalb ihrer Struktur andere Steuerelemente enthalten (z. B. Bearbeitungssteuerelemente und Kombinationsfelder). Diese Steuerelemente sind oben in der Inhalts- und der Steuerelementansicht als "andere Steuerelemente" gemeint.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle sind die UI Automation-Eigenschaften aufgeführt, deren Wert oder Definition speziell für MenuBar-Steuerelemente relevant ist. Weitere Informationen zu UI Automationseigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-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 MenuBar-Steuerelement muss nur dann einen Namen haben, wenn eine Anwendung über mehrere Menüleisten verfügt. Wenn eine Anwendung über mehrere Menüleisten verfügt, sollten in dieser Eigenschaft gut zu unterscheidende Namen angegeben werden (wie "Formatierung" oder "Gliederung").

LabeledByProperty

Null

MenuBar-Steuerelemente haben niemals eine Bezeichnung.

ControlTypeProperty

MenuBar

Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.

LocalizedControlTypeProperty

"Menüleiste"

Lokalisierte Zeichenfolge, die dem MenuBar-Steuerelementtyp entspricht.

IsContentElementProperty

True

Das MenuBar-Steuerelement ist stets in der Inhaltsansicht der UI Automation-Struktur enthalten.

IsControlElementProperty

True

Das MenuBar-Steuerelement ist stets in der Steuerelementansicht der UI Automation-Struktur enthalten.

IsOffscreenProperty

Siehe Hinweise.

Der Wert dieser Eigenschaft ist davon abhängig, ob das Steuerelement auf dem Bildschirm angezeigt werden kann.

OrientationProperty

Variabel

Diese Eigenschaft gibt an, ob das MenuBar-Steuerelement horizontal oder vertikal verläuft.

IsKeyboardFocusableProperty

True

MenuBar-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 MenuBar-Steuerelement erforderlich ist.

AcceleratorKeyProperty

Null

Menüleisten haben niemals Tastenkombinationen.

AccessKeyProperty

"ALT"

Wenn die ALT-TASTE gedrückt wird, sollte der Fokus stets zur Menüleiste in der Anwendung wechseln.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle sind die UI Automation-Steuerelementmuster aufgeführt, die von allen MenuBar-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmuster

Unterstützung

Hinweise

IExpandCollapseProvider

Variabel

Wenn das Steuerelement erweitert oder reduziert werden kann, implementieren Sie IExpandCollapseProvider.

IDockProvider

Variabel

Wenn das Steuerelement an verschiedene Teile des Bildschirms angedockt werden kann, implementieren IDockProvider.

ITransformProvider

Variabel

Wenn das Steuerelement gedreht, verschoben oder in der Größe geändert werden kann, muss es ITransformProvider implementieren.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle sind die UI Automation-Ereignisse aufgeführt, die von allen MenuBar-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI Automation-Ereignis

Unterstützung/Wert

Hinweise

Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte ExpandCollapseStateProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

AutomationFocusChangedEvent

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Siehe auch

Referenz

MenuBar

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung