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 ISelectionProviderimplementieren.
Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und deren unterstützte Steuerelementmuster.
Dieses Thema enthält die folgenden Abschnitte.
- Implementierungsrichtlinien und -konventionen
- Erforderliche Member für ISelectionItemProvider-
- Verwandte Themen
Implementierungsrichtlinien und -konventionen
Beachten Sie bei der Implementierung des SelectionItem- Steuerelementmusters die folgenden Richtlinien und Konventionen:
- Steuerelemente für einmalige Auswahl, die untergeordnete Steuerelemente verwalten, die IRawElementProviderFragmentRoot-implementieren, z. B. der Bildschirmauflösung Schieberegler im Dialogfeld Anzeigeeigenschaften für Windows, sollten ISelectionProviderimplementieren; ihre untergeordneten Elemente sollten sowohl IRawElementProviderFragment als auch ISelectionItemProviderimplementieren.
Erforderliche Elemente für ISelectionItemProvider-
Die folgenden Eigenschaften, Methoden und Ereignisse sind für die Implementierung der ISelectionItemProvider Schnittstelle erforderlich.
| Erforderliche Mitglieder | Elementtyp | Notizen |
|---|---|---|
| AddToSelection- | Methode | Nichts |
| isSelected | Eigentum | Nichts |
| RemoveFromSelection- | Methode | Nichts |
| auswählen | Methode | Nichts |
| SelectionContainer- | Eigentum | Nichts |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Ereignis | Nichts |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Ereignis | Nichts |
| UIA_SelectionItem_ElementSelectedEventId | Ereignis | Nichts |
Wenn das Ergebnis eines Select, ein AddToSelection-oder ein RemoveFromSelection- ein einzelnes ausgewähltes Element ist, sollte ein ElementSelected-Ereignis (UIA_SelectionItem_ElementSelectedEventId) ausgelöst werden; andernfalls ElementAddedToSelection (UIA_SelectionItem_ElementAddedToSelectionEventId) oder ElementRemovedFromSelection (UIA_SelectionItem_ElementRemovedFromSelectionEventId) Ereignisse entsprechend auslösen.
Verwandte Themen
-
Steuerelementtypen und deren unterstützte Steuerelementmuster
-
Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung
-
übersicht über Benutzeroberflächenautomatisierungsstruktur