SelectionItem-Steuerelementmuster
Beschreibt Richtlinien und Konventionen für die Implementierung von ISelectionItemProvider, einschließlich Informationen zu Eigenschaften, Methoden und Ereignissen. Das SelectionItem-Steuerelementmuster wird verwendet, um Steuerelemente zu unterstützen, die als einzelne, auswählbare untergeordnete Elemente von Containersteuerelementen fungieren, die ISelectionProvider implementieren.
Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und ihre unterstützten Steuerelementmuster.
Dieses Thema enthält folgende Abschnitte:
- Implementierungsrichtlinien und -konventionen
- Erforderliche Member für ISelectionItemProvider
- Zugehörige Themen
Implementierungsrichtlinien und -konventionen
Beachten Sie beim Implementieren des SelectionItem-Steuerelementmusters die folgenden Richtlinien und Konventionen:
- Steuerelemente mit einmaliger Auswahl, die untergeordnete Steuerelemente verwalten, die IRawElementProviderFragmentRoot implementieren, z. B. der Schieberegler Bildschirmauflösung im Dialogfeld Anzeigeeigenschaften für Windows, sollten ISelectionProvider implementieren. Ihre untergeordneten Elemente sollten sowohl IRawElementProviderFragment als auchISelectionItemProvider implementieren.
Erforderliche Member für ISelectionItemProvider
Die folgenden Eigenschaften, Methoden und Ereignisse sind für die Implementierung der ISelectionItemProvider-Schnittstelle erforderlich.
| Erforderliche Member | Memberart | Hinweise |
|---|---|---|
| AddToSelection | Methode | Keine |
| Isselected | Eigenschaft | Keine |
| RemoveFromSelection | Methode | Keine |
| Select | Methode | Keine |
| Selectioncontainer | Eigenschaft | Keine |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Ereignis | Keine |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Ereignis | Keine |
| UIA_SelectionItem_ElementSelectedEventId | Ereignis | Keine |
Wenn das Ergebnis eines Select-Elements, einer AddToSelection oder einer RemoveFromSelection ein einzelnes ausgewähltes Element ist, sollte ein ElementSelected-Ereignis (UIA_SelectionItem_ElementSelectedEventId) ausgelöst werden. andernfalls werden die Ereignisse ElementAddedToSelection (UIA_SelectionItem_ElementAddedToSelectionEventId) oder ElementRemovedFromSelection (UIA_SelectionItem_ElementRemovedFromSelectionEventId) nach Bedarf ausgelöst.
Zugehörige Themen
-
Steuerelementtypen und ihre unterstützten Steuerelementmuster
-
Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung
-
Übersicht über die Benutzeroberflächenautomatisierungs-Struktur