Freigeben über


MenuItem-Steuerelementtyp

Dieses Thema enthält Informationen zur Unterstützung des MenuItem-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.

Ein Menüsteuerelement ermöglicht die hierarchische Organisation von Elementen, die Befehlen und Ereignishandlern zugeordnet sind. In einer typischen Windows-Anwendung enthält eine Menüleiste mehrere Menüelemente (z. B . Datei, Bearbeiten und Fenster), und jedes Menüelement zeigt ein Menü an. Ein Menü enthält eine Sammlung von Menüelementen (z. B. Neu, Öffnenund Schließen), die erweitert werden können, um weitere Menüelemente anzuzeigen, oder auf die geklickt werden kann, um eine bestimmte Aktion auszuführen.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den MenuItem-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Menüelementsteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Benutzeroberflächenplattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur der Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Menüelementsteuerelemente 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
  • MenuItem „Hilfe“ (?)
    • Menü (Untermenü des Menüelements Hilfe)
      • MenuItem „Hilfethemen“
      • MenuItem „Info“
  • MenuItem „Hilfe“ (?)
    • MenuItem „Hilfethemen“
    • MenuItem „Info“

 

Die Steuerelementansicht des MenuItem-Steuerelements verfügt über die oben gezeigte Benutzeroberflächenautomatisierungs-Struktur. Beachten Sie, dass das Menüelement für Hilfe auf der Menüleiste hinzugefügt wurde, um die Struktur besser zu veranschaulichen.

Für die Inhaltsansicht fehlt Menü in der Benutzeroberflächenautomatisierung-Struktur, da es dem Endbenutzer keine aussagekräftigen Informationen vermittelt.

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für den MenuItem-Steuerelementtyp besonders relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Hinweise
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein. Ordnen Sie die AutomationId-Eigenschaft für ein Menüelement zu, wenn bekannt ist, dass das Element in verschiedenen Instanzen der Benutzeroberfläche konsistent ist. Wenn das Menüelement dynamisch aufgefüllt und nicht vorhersagbar ist, lassen Sie die AutomationId-Eigenschaft leer.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußere Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Unterstützt, wenn es ein umschließendes Rechteck gibt. Wenn nicht jeder Punkt innerhalb des begrenzungsenden Rechtecks geklickt werden kann und das Element spezielle Treffertests ausführt, überschreiben Sie, und stellen Sie einen klickbaren Punkt bereit.
UIA_ControlTypePropertyId MenuItem
UIA_IsContentElementPropertyId TRUE Das Menüelementsteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten.
UIA_IsControlElementPropertyId TRUE Das Menüelementsteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur enthalten.
UIA_IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem MenuItem-Steuerelementtyp entspricht. Der Standardwert ist "Menüelement" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Der Name des Menüelementsteuerelements ist der Text, der zum Bezeichnen verwendet wird.

 

Erforderliche Steuerelementmuster

In der folgenden Tabellen sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von den MenuItem-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster Support Hinweise
IExpandCollapseProvider Depends (Abhängig) Wenn das Steuerelement erweitert oder reduziert werden kann, implementieren Sie IExpandCollapseProvider.
IInvokeProvider Depends (Abhängig) Wenn das Steuerelement eine einzelne Aktion oder einen einzelnen Befehl ausführt, implementieren Sie IInvokeProvider.
ISelectionItemProvider Depends (Abhängig) Wenn das Steuerelement verwendet wird, um aus einer Liste von Optionen zwischen Menüelementen auszuwählen, implementieren Sie ISelectionItemProvider.
IToggleProvider Depends (Abhängig) Wenn das Steuerelement eine Option darstellt, die aktiviert oder deaktiviert werden kann, implementieren Sie IToggleProvider.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Menüelementsteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Hinweise
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_Invoke_InvokedEventId Wenn das Steuerelement das Invoke-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_SelectionItem_ElementAddedToSelectionEventId Wenn das Steuerelement das SelectionItem-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_SelectionItem_ElementRemovedFromSelectionEventId Wenn das Steuerelement das SelectionItem-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_SelectionItem_ElementSelectedEventId Wenn das Steuerelement das SelectionItem-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Umschalter-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

 

Legacyprobleme

Für Microsoft Win32-Menüelemente wird das Steuerelementmuster umschalten nur unterstützt, wenn ein Menüelement aktiviert ist, und es ist möglich, programmgesteuert zu bestimmen, ob unterstützung für das Umschaltsteuerelementmuster erforderlich ist. Da ein Win32-Menüelement nicht verfügbar macht, ob es aktiviert werden kann, wird das Steuerelementmuster Invoke unterstützt, wenn das Menüelement nicht aktiviert ist. Das Invoke-Steuerelementmuster wird immer unterstützt, auch für Menüelemente, die nur zur Unterstützung des Steuerelementmusters "Umschalten" erforderlich sind. Dies ist so, dass Clients nicht verwirrt werden, wenn ein Menüelement, das das Steuerelementmuster Invoke unterstützte (wenn das Menüelement deaktiviert wurde) dieses Muster nicht mehr unterstützt, wenn es aktiviert wird.

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung