Implementieren des Selection-Steuerelementmusters der Benutzeroberflächenautomatisierung

Artikel
08/10/2011

Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

In diesem Thema werden Richtlinien und Konventionen zum Implementieren von ISelectionProvider vorgestellt sowie Ereignisse und Eigenschaften erläutert. Am Ende des Themas finden Sie Links zu zusätzlichen Verweisen.

Das SelectionPattern-Steuerelementmuster wird zur Unterstützung von Steuerelementen verwendet, die als Container für eine Auflistung von untergeordneten, auswählbaren Elementen dienen. Von den untergeordneten Elementen dieses Elements muss ISelectionItemProvider implementiert werden. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Zuordnen von Steuerelementmustern für Benutzeroberflächenautomatisierungs-Clients.

Dieses Thema enthält folgende Abschnitte.

Implementierungsrichtlinien und Konventionen
Erforderliche Member für ISelectionProvider
Ausnahmen
Verwandte Abschnitte

Implementierungsrichtlinien und Konventionen

Beachten Sie beim Implementieren des Selection-Steuerelementmusters die folgenden Richtlinien und Konventionen:

Mit Steuerelementen, von denen ISelectionProvider implementiert wird, können einzelne oder mehrere untergeordneten Elemente ausgewählt werden. Beispielsweise wird von ListBox, ListView und TreeView die Mehrfachauswahl, von ComboBox, Slider und RadioButton-Gruppen nur die Einzelauswahl unterstützt.
Von Steuerelementen mit minimalen, maximalen und durchgehenden Bereichen, wie z. B. dem Slider-Steuerelement Lautstärke, sollte IRangeValueProvider anstelle von ISelectionProvider implementiert werden.
Von Steuerelementen mit Einzelauswahl, von denen untergeordnete, IRawElementProviderFragmentRoot implementierende Steuerelemente verwaltet werden, wie z. B. der Schieberegler Bildschirmauflösung im Dialogfeld Anzeigeeigenschaften oder das Auswahlsteuerelement Farbauswahl von Microsoft Word (unten dargestellt), sollte ISelectionProvider implementiert werden. Von deren untergeordneten Elementen sollte sowohl IRawElementProviderFragment als auch ISelectionItemProvider implementiert werden.

Beispiel für eine Farbfeld-Zeichenfolgenzuordnung

Farbauswahl mit ausgewählter Farbe Gelb.

Von Menüs werden keine SelectionPattern unterstützt. Wenn Sie mit Menüelementen arbeiten, die sowohl Grafik als auch Text enthalten (wie z. B. die Vorschaubereich-Elemente im Menü Ansicht von Microsoft Outlook) und den Status anzeigen müssen, sollten Sie IToggleProvider implementieren.

Erforderliche Member für ISelectionProvider

Für die ISelectionProvider-Schnittstelle werden die folgenden Eigenschaften, Methoden und Ereignisse benötigt.

Erforderliche Member	Typ	Hinweise
CanSelectMultiple	Eigenschaft	Durch geänderte Eigenschaften ausgelöste Ereignisse sollten unter Verwendung von AddAutomationPropertyChangedEventHandler und RemoveAutomationPropertyChangedEventHandler unterstützt werden.
IsSelectionRequired	Eigenschaft	Durch geänderte Eigenschaften ausgelöste Ereignisse sollten unter Verwendung von AddAutomationPropertyChangedEventHandler und RemoveAutomationPropertyChangedEventHandler unterstützt werden.
GetSelection	Methode	Keine
InvalidatedEvent	Ereignis	Wird ausgelöst, wenn eine Auswahl in einem Container erheblich geändert wurde und mehr Hinzufügen- und Entfernen-Ereignisse gesendet werden müssen, als die InvalidateLimit-Konstante zulässt.

Die IsSelectionRequired-Eigenschaft und die CanSelectMultiple-Eigenschaft können dynamisch sein. Im Ausgangszustand eines Steuerelements können z. B. in der Standardeinstellung keine Elemente ausgewählt sein, d. h. IsSelectionRequired ist false. Nach der Auswahl eines Elements muss in dem Steuerelement jedoch immer mindestens ein Element ausgewählt sein. Entsprechend kann ein Steuerelement in seltenen Fällen bei der Initialisierung die Auswahl von mehreren Elementen, danach jedoch nur noch Einzelauswahlen zulassen.