Auswahlsteuermuster
Beschreibt Richtlinien und Konventionen für die Implementierung von ISelectionProvider,einschließlich Informationen zu Eigenschaften, Methoden und Ereignissen. Das Selection-Steuerelementmuster wird verwendet, um Steuerelemente zu unterstützen, die als Container für eine Auflistung auswählbarer untergeordneter Elemente fungieren. Die unteren Elemente dieses Elements müssen ISelectionItemProvider 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 ISelectionProvider
- Zugehörige Themen
Implementierungsrichtlinien und -konventionen
Beachten Sie beim Implementieren des Selection-Steuerelementmusters die folgenden Richtlinien und Konventionen:
Steuerelemente, die ISelectionProvider implementieren, ermöglichen die Auswahl einzelner oder mehrerer untergeordneter Elemente. Listenfelder, Listenansichten und Strukturansichten unterstützen beispielsweise mehrfache Auswahl, während Kombinationsfelder, Schieberegler und Optionsfeldgruppen eine einzelne Auswahl unterstützen.
Steuerelemente, die über einen minimalen, maximalen und kontinuierlichen Bereich verfügen, z. B. das Volume-Schieberegler-Steuerelement eines Media Players, sollten IRangeValueProvider anstelle von ISelectionProvider implementieren.
Steuerelemente mit einzelner Auswahl, die untergeordnete Steuerelemente verwalten, die IRawElementProviderFragmentRootimplementieren, z. B. der Bildschirmauflösungsschieberegler im Anzeigeeigenschaften-Dialogfeld für Windows oder das Farbwähler-Auswahlsteuerelement von Microsoft Word (siehe folgende Abbildung), sollten ISelectionProvider implementieren. ihre children-Objekte sollten sowohl IRawElementProviderFragment als auch ISelectionItemProvider implementieren.

Menüs unterstützen das Auswahlsteuerelementmuster nicht. Wenn Sie mit Menüelementen arbeiten, die Grafiken und Text enthalten (z. B. die Elemente des Vorschaubereichs im Menü Ansicht in Microsoft Outlook), und den Zustand übermitteln müssen, sollten Sie IToggleProvider implementieren.
Erforderliche Member für ISelectionProvider
Die folgenden Eigenschaften, Methoden und Ereignisse sind für die Implementierung der ISelectionProvider-Schnittstelle erforderlich.
| Erforderliche Member | Memberart | Hinweise |
|---|---|---|
| CanSelectMultiple | Eigenschaft | Keine |
| IsSelectionRequired | Eigenschaft | Keine |
| GetSelection | Methode | Keine |
| UIA _ Selection _ InvalidatedEventId | Ereignis | Dieses Ereignis wird aus, wenn sich eine Auswahl in einem Container erheblich geändert hat. |
Die Eigenschaften ISelectionProvider::IsSelectionRequired und CanSelectMultiple können dynamisch sein. Beispielsweise sind für den Anfangszustand eines Steuerelements möglicherweise standardmäßig keine Elemente ausgewählt, was darauf hinweist, dass IsSelectionRequired false ist. Nach dem Auswählen eines Elements muss für das Steuerelement jedoch immer mindestens ein Element ausgewählt sein. Auf ähnliche Weise kann ein Steuerelement in seltenen Fällen bei der Initialisierung die Mehrfachauswahl von Elementen gestatten, während anschließend nur noch die Einfachauswahl zulässig ist.