Freigeben über

MenuItem-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den MenuItem- Steuerelementtyp.

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-, Bearbeitenund Fenster-), und jedes Menüelement zeigt ein Menü an. Ein Menü enthält eine Sammlung von Menüelementen (z. B. Neue, Öffnenund Schließen), die erweitert werden kann, um zusätzliche Menüelemente anzuzeigen oder eine bestimmte Aktion auszuführen, wenn darauf geklickt wird.

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

Dieses Thema enthält die folgenden Abschnitte.

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Menüelementsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • MenuItem "Help"
    • Menü (Untermenü des Hilfemenüelements)
      • MenuItem "Hilfethemen"
      • MenuItem "About Notepad"
  • MenuItem "Help"
    • MenuItem "Hilfethemen"
    • MenuItem "About Notepad"

 

Die Steuerelementansicht des Menüelementsteuerelements weist die oben gezeigte Struktur der Benutzeroberflächenautomatisierung auf. 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ächenautomatisierungs-Struktur, da sie dem Endbenutzer keine aussagekräftigen Informationen vermittelt.

Relevante Eigenschaften

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

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein. Weisen Sie die AutomationId Eigenschaft für ein Menüelement zu, wenn das Element bekannt ist, dass es in verschiedenen Instanzen der Benutzeroberfläche konsistent ist. Wenn das Menüelement dynamisch ausgefüllt und nicht vorhersehbar ist, lassen Sie die AutomationId Eigenschaft leer.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußerste Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Wird unterstützt, wenn ein umgebendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umgebenden Rechtecks klickbar ist und das Element spezielle Treffertests durchführt, überschreiben Und stellen Sie einen klickbaren Punkt bereit.
UIA_ControlTypePropertyId MenuItem-
UIA_IsContentElementPropertyId STIMMT Das Menüelementsteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsControlElementPropertyId STIMMT Das Menüelement-Steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-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, mit dem es beschriftet wird.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von Menüelementsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.

Steuerelementmuster Unterstützen Notizen
IExpandCollapseProvider Hängt Wenn das Steuerelement erweitert oder reduziert werden kann, implementieren Sie IExpandCollapseProvider.
IInvokeProvider- Hängt Wenn das Steuerelement eine einzelne Aktion oder einen einzelnen Befehl ausführt, implementieren Sie IInvokeProvider-.
ISelectionItemProvider- Hängt Wenn das Steuerelement verwendet wird, um aus einer Liste von Optionen zwischen Menüelementen auszuwählen, implementieren Sie ISelectionItemProvider.
IToggleProvider- Hängt Wenn das Steuerelement eine Option darstellt, die ein- oder ausgeschaltet werden kann, implementieren Sie IToggleProvider-.

 

Erforderliche Ereignisse

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

Benutzeroberflächenautomatisierungs-Ereignis Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_ExpandCollapseExpandCollapseStatePropertyId Eigenschaftsänderungsereignis. 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 Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden.
UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. 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 Eigenschaftsänderungsereignis. Wenn das Steuerelement das Umschalten Steuerelementmusters unterstützt, muss es dieses Ereignis unterstützen.

 

Legacyprobleme

Bei Microsoft Win32-Menüelementen wird das Umschalten Steuerelementmusters nur unterstützt, wenn ein Menüelement überprüft wird und programmgesteuert ermittelt werden kann, ob die Unterstützung für das Umschaltsteuerelementmuster erforderlich ist. Da ein Win32-Menüelement nicht verfügbar macht, ob es überprüft werden kann, wird das Aufruf-Steuerelementmuster unterstützt, wenn das Menüelement nicht aktiviert ist. Das Aufruf-Steuerelementmuster wird immer unterstützt, auch für Menüelemente, die nur zur Unterstützung des Umschalten-Steuerelementmusters erforderlich sind. Dies ist so, dass Clients nicht verwirrt werden, wenn ein Menüelement, das das Invoke Steuerelementmuster unterstützt (wenn das Menüelement deaktiviert wurde) dieses Muster nicht mehr unterstützt, wenn es überprüft wird.

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung