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
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Legacyprobleme
- Zugehörige Themen
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 |
|---|---|
|
|
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.
Zugehörige Themen