Freigeben über

Menüsteuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Microsoft Benutzeroberflächenautomatisierung Unterstützung für den Menüsteuerelementtyp.

Ein Menüsteuerelement ermöglicht die hierarchische Organisation von Elementen, die Befehlen und Ereignishandlern zugeordnet sind. In einer typischen Microsoft Windows-Anwendung enthält eine Menüleiste verschiedene Menüschaltflächen (etwa Datei, Bearbeiten und Fenster), und nach dem Klicken auf eine Menüschaltfläche wird ein Menü angezeigt. 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 Menu-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Menüsteuerelemente, 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üsteuerelemente 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
  • Menü
    • MenuItem (1 oder viele)
    • Andere Steuerelemente (0 oder viele)
  • Menü
    • MenuItem (1 oder viele)
    • Andere Steuerelemente (0 oder viele)

 

Menüsteuerelemente werden immer in der Steuerelementansicht und der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung angezeigt. Menüsteuerelemente sollten unter dem Steuerelement angezeigt werden, auf das sich ihre Informationen beziehen. Benutzeroberflächenautomatisierung Clients können auf UIA_MenuOpenedEventId lauschen, um sicherzustellen, dass sie konsistent Informationen erhalten, die von Menüsteuerelementen übermittelt werden. Kontextmenü-Steuerelemente sind ein besonderer Fall. Sie können als untergeordnete Elemente des Desktops oder eines Anwendungsfensters der obersten Ebene angezeigt werden.

Ein Menüsteuerelement kann andere Steuerelemente enthalten, z. B. Bearbeitungssteuerelemente und Kombinationsfelde, in seiner Struktur. Diese zusätzlichen Steuerelemente entsprechen den "anderen Steuerelementen", die in der vorherigen Tabelle in der Steuerelement- und Inhaltsansicht aufgeführt sind.

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition besonders für den Menu-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_ControlTypePropertyId Menü
UIA_IsContentElementPropertyId TRUE Das Menüsteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten.
UIA_IsControlElementPropertyId TRUE Das Menüsteuerelement ist stets in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung enthalten.
UIA_LabeledByPropertyId NULL Für ein typisches Menüsteuerelement wird keine Bezeichnung erwartet.
UIA_NamePropertyId Siehe Hinweise. Für das Menüsteuerelement muss keine Name-Eigenschaft festgelegt werden, oder es kann denselben Namen wie das zugeordnete Steuerelement haben, z. B. ein Menüelement, das das Untermenü geöffnet hat.

 

Erforderliche Steuerelementmuster

Für den Menu-Steuerelementtyp gibt es keine erforderlichen Steuerelementmuster.

Erforderliche Ereignisse

Menüsteuerelemente müssen das UIA_MenuOpenedEventId-Ereignis auslösen, wenn sie auf dem Bildschirm angezeigt werden. Das UIA_MenuOpenedEventId-Ereignis enthält den Text des Steuerelements. Das UIA_MenuClosedEventId-Ereignis muss ausgelöst werden, wenn ein Menü vom Bildschirm verschwindet.

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Menüsteuerelemente 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_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_MenuClosedEventId
UIA_MenuOpenedEventId
UIA_StructureChangedEventId

 

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung