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 einzelner Auswahl, die untergeordnete Steuerelemente verwalten, die IRawElementProviderFragmentRootimplementieren , z. B. der Bildschirmauflösungsschieberegler im Anzeigeeigenschaften-Dialogfeld für Windows, sollten ISelectionProvider implementieren. ihre children-Objekte sollten sowohl IRawElementProviderFragment als auch ISelectionItemProvider 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 von Select, AddToSelectionoder RemoveFromSelection ein einzelnes ausgewähltes Element ist, sollte ein ElementSelected-Ereignis (UIA _ SelectionItem _ ElementSelectedEventId) ausgelöst werden. Andernfalls sollten ElementAddedToSelection -Ereignisse (UIA _ SelectionItem-ElementAddedToSelectionEventId _) oder ElementRemovedFromSelection (UIA _ SelectionItem _ ElementRemovedFromSelectionEventId) entsprechend ausgelöst werden.