Benutzeroberflächenautomatisierungs-Unterstützung für den MenuBar-SteuerelementtypUI Automation Support for the MenuBar Control Type

Hinweis

Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten BenutzeroberflächenautomatisierungUI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.This documentation is intended for .NET Framework developers who want to use the managed BenutzeroberflächenautomatisierungUI Automation classes defined in the System.Windows.Automation namespace. Die neuesten Informationen zu BenutzeroberflächenautomatisierungUI Automation, finden Sie unter Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.For the latest information about BenutzeroberflächenautomatisierungUI Automation, see Windows Automation API: UI Automation.

Dieses Thema enthält Informationen über BenutzeroberflächenautomatisierungUI Automation -Unterstützung für den MenuBar -Steuerelementtyp.This topic provides information about BenutzeroberflächenautomatisierungUI Automation support for the MenuBar control type. In BenutzeroberflächenautomatisierungUI Automationumfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty -Eigenschaft verwendet werden kann.In BenutzeroberflächenautomatisierungUI Automation, a control type is a set of conditions that a control must meet in order to use the ControlTypeProperty property. Die Bedingungen schließen bestimmte Richtlinien für BenutzeroberflächenautomatisierungUI Automation -Struktur, BenutzeroberflächenautomatisierungUI Automation -Eigenschaftswerte und Steuerelementmuster ein.The conditions include specific guidelines for BenutzeroberflächenautomatisierungUI Automation tree structure, BenutzeroberflächenautomatisierungUI Automation property values and control patterns.

Ein Beispiel für Steuerelemente, die den MenuBar-Steuerelementtyp implementieren, sind Menüleisten-Steuerelemente.Menu bar controls are an example of controls that implement the MenuBar control type. Menüleisten geben dem Benutzer die Möglichkeit, Befehle und Optionen zu aktivieren, die in einer Anwendung enthalten sind.Menu bars provide a means for users to activate commands and options contained in an application.

In den folgenden Abschnitten werden die BenutzeroberflächenautomatisierungUI Automation -Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Steuerelementtyp „MenuBar“ erforderlich sind.The following sections define the required BenutzeroberflächenautomatisierungUI Automation tree structure, properties, control patterns, and events for the MenuBar control type. Die BenutzeroberflächenautomatisierungUI Automation -Anforderungen gelten für alle Listensteuerelemente in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), Win32Win32oder Windows FormsWindows Forms.The BenutzeroberflächenautomatisierungUI Automation requirements apply to all list controls, whether Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), Win32Win32, or Windows FormsWindows Forms.

Erforderliche Benutzeroberflächenautomatisierungs-StrukturRequired UI Automation Tree Structure

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der BenutzeroberflächenautomatisierungUI Automation -Struktur für Menüleisten-Steuerelemente sowie die möglichen Inhalte der Ansichten beschrieben.The following table depicts the control view and the content view of the BenutzeroberflächenautomatisierungUI Automation tree that pertains to menu bar controls and describes what can be contained in each view. Weitere Informationen zur BenutzeroberflächenautomatisierungUI Automation -Struktur finden Sie unter UI Automation Tree Overview.For more information on the BenutzeroberflächenautomatisierungUI Automation tree, see UI Automation Tree Overview.

SteuerelementansichtControl View InhaltsansichtContent View
MenuBarMenuBar

-MenuItem (1 oder mehr)- MenuItem (1 or more)
-Andere Steuerelemente (0 oder viele)- Other controls (0 or many)
MenuBarMenuBar

-MenuItem (1 oder mehr)- MenuItem (1 or more)
-Andere Steuerelemente (0 oder viele)- Other controls (0 or many)

Menüleisten-Steuerelemente können in ihrer Struktur andere Steuerelemente enthalten (z. B. Bearbeitungssteuerelemente und Kombinationsfelder).Menu bar controls can contain other controls such as edit controls and combo boxes within its structure. Diese weiteren Steuerelemente sind oben in der Inhalts- und der Steuerelementansicht mit „Andere Steuerelemente“ gemeint.These additional controls correspond to the "other controls" listed above in the control and content views.

Erforderliche Benutzeroberflächenautomatisierungs-EigenschaftenRequired UI Automation Properties

In der folgenden Tabelle werden die BenutzeroberflächenautomatisierungUI Automation -Eigenschaften aufgelistet, deren Wert oder Definition für ein Menüleisten-Steuerelement besonders relevant ist.The following table lists the BenutzeroberflächenautomatisierungUI Automation properties whose value or definition is especially relevant to the menu bar controls. Weitere Informationen zu BenutzeroberflächenautomatisierungUI Automation Eigenschaften finden Sie UI Automation Properties for Clients.For more information on BenutzeroberflächenautomatisierungUI Automation properties, see UI Automation Properties for Clients.

BenutzeroberflächenautomatisierungUI Automation -EigenschaftProperty WertValue HinweiseNotes
BoundingRectangleProperty Siehe Hinweise.See notes. Der von dieser Eigenschaft verfügbar gemachte Wert muss sämtliche darin enthaltenen Steuerelemente umfassen.The value exposed by this property must include all of the controls contained within it.
NameProperty Siehe Hinweise.See notes. Das Menüleisten-Steuerelement muss nur dann einen Namen haben, wenn eine Anwendung mehrere Menüleisten hat.The menu bar control does not need a name unless an application has more than one menu bar. Hat eine Anwendung mehrere Menüleisten, sollte diese Eigenschaft dazu verwendet werden, gut zu unterscheidende Namen verfügbar zu machen (etwa „Formatierung“ oder „Gliederung“).If there is more than one menu bar in an application, then this property should be used to expose distinguishing names, such as "Formatting" or "Outlining."
LabeledByProperty Null Menüleisten-Steuerelemente haben niemals eine Bezeichnung.Menu bar controls never have a label.
ControlTypeProperty MenuBarMenuBar Dieser Wert ist für alle Benutzeroberflächenframeworks gleich.This value is the same for all UI frameworks.
LocalizedControlTypeProperty „Menüleiste“"menu bar" Lokalisierte Zeichenfolge für den Steuerelementtyp „MenuBar“.Localized string corresponding to the MenuBar control type.
IsContentElementProperty TrueTrue Das Menüleisten-Steuerelement ist stets in der Inhaltsansicht der BenutzeroberflächenautomatisierungUI Automation -Struktur enthalten.The menu bar control is always included in the content view of the BenutzeroberflächenautomatisierungUI Automation tree.
IsControlElementProperty TrueTrue Das Menüleisten-Steuerelement ist stets in der Steuerelementansicht der BenutzeroberflächenautomatisierungUI Automation -Struktur enthalten.The menu bar control is always included in the control view of the BenutzeroberflächenautomatisierungUI Automation tree.
IsOffscreenProperty Siehe Hinweise.See notes. Der Wert dieser Eigenschaft ist hängt davon ab, ob das Steuerelement auf dem Bildschirm angezeigt werden kann.The value of this property depends on whether the control is viewable on the screen.
OrientationProperty VariabelDepends Diese Eigenschaft gibt an, ob das Menüleisten-Steuerelement horizontal oder vertikal verläuft.This property exposes whether the menu bar control is horizontal or vertical.
IsKeyboardFocusableProperty TrueTrue Menüleisten-Steuerelemente können den Tastaturfokus erhalten, da die in ihnen enthaltenen Steuerelemente den Tastaturfokus übernehmen können.Menu bar controls are keyboard-focusable because the controls they contain can take keyboard focus.
HelpTextProperty Siehe Hinweise.See notes. Keine Szenarios dafür, wann Hilfetext für ein Menüleisten-Steuerelement erforderlich ist.No scenarios for when Help text is required for a menu bar control.
AcceleratorKeyProperty Null Menüleisten haben niemals Tastenkombinationen.Menu bars never have accelerator keys.
AccessKeyProperty „ALT“"ALT" Ein Drücken der ALT-TASTE sollte immer bewirken, dass die Menüleiste den Fokus in der Anwendung erhält.Pressing the ALT key should always bring focus to the menu bar within the application.

Erforderliche Benutzeroberflächenautomatisierungs-SteuerelementmusterRequired UI Automation Control Patterns

In der folgenden Tabelle werden die BenutzeroberflächenautomatisierungUI Automation -Steuerelementmuster aufgelistet, die von allen Menüleisten-Steuerelementen unterstützt werden müssen.The following table lists the BenutzeroberflächenautomatisierungUI Automation control patterns required to be supported by menu bar controls. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.For more information on control patterns, see UI Automation Control Patterns Overview.

SteuerelementmusterControl Pattern UnterstützungSupport HinweiseNotes
IExpandCollapseProvider VariabelDepends Wenn das Steuerelement erweitert oder reduziert werden kann, implementieren Sie IExpandCollapseProvider.If the control can be expanded or collapsed, implement IExpandCollapseProvider.
IDockProvider VariabelDepends Wenn das Steuerelement an verschiedenen Teilen des Bildschirms angedockt werden kann, implementieren Sie IDockProvider.If the control can be docked to different parts of the screen, implement IDockProvider.
ITransformProvider VariabelDepends Wenn das Steuerelement gedreht, verschoben oder in der Größe geändert werden kann, muss es ITransformProviderimplementieren.If the control can be resized, rotated or moved it must implement ITransformProvider.

Erforderliche Benutzeroberflächenautomatisierungs-EreignisseRequired UI Automation Events

Die folgende Tabelle enthält die BenutzeroberflächenautomatisierungUI Automation -Ereignisse, die von allen Menüleisten-Steuerelementen unterstützt werden müssen.The following table lists the BenutzeroberflächenautomatisierungUI Automation events required to be supported by all menu bar controls. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.For more information on events, see UI Automation Events Overview.

BenutzeroberflächenautomatisierungUI Automation -EreignisEvent Unterstützung/WertSupport/Value HinweiseNotes
Durch geänderteBoundingRectangleProperty -Eigenschaft ausgelöstes Ereignis.BoundingRectangleProperty property-changed event. ErforderlichRequired KeinerNone
Durch geänderteIsOffscreenProperty -Eigenschaft ausgelöstes Ereignis.IsOffscreenProperty property-changed event. ErforderlichRequired KeinerNone
Durch geänderteIsEnabledProperty -Eigenschaft ausgelöstes Ereignis.IsEnabledProperty property-changed event. ErforderlichRequired KeinerNone
Durch geänderteExpandCollapseStateProperty -Eigenschaft ausgelöstes Ereignis.ExpandCollapseStateProperty property-changed event. VariabelDepends KeinerNone
AutomationFocusChangedEvent ErforderlichRequired KeinerNone
StructureChangedEvent ErforderlichRequired KeinerNone

Siehe auchSee also