Implementieren des SelectionItem-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 ISelectionItemProvider vorgestellt und Eigenschaften, Methoden sowie Ereignisse erläutert. Am Ende der Übersicht finden Sie Links zu zusätzlichen Verweisen.

Mit dem SelectionItemPattern-Steuerelementmuster werden Steuerelemente unterstützt, die als einzelne, auswählbare untergeordnete Elemente von Containersteuerelementen ausgeführt werden. Diese Containersteuerelemente implementieren ISelectionProvider. Beispiele für Steuerelemente, die das SelectionItem-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 ISelectionItemProvider
Ausnahmen
Verwandte Abschnitte

Implementierungsrichtlinien und Konventionen

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

Von Steuerelementen mit Einzelauswahl, von denen untergeordnete, IRawElementProviderFragmentRoot implementierende Steuerelemente verwaltet werden, wie z. B. der Schieberegler Bildschirmauflösung im Dialogfeld Anzeigeeigenschaften, sollten ISelectionProvider implementiert werden. Von deren untergeordneten Elementen sollten sowohl IRawElementProviderFragment als auch ISelectionItemProvider implementiert werden.

Erforderliche Member für ISelectionItemProvider

Zum Implementieren von ISelectionItemProvider werden die folgenden Eigenschaften, Methoden und Ereignisse benötigt.

Erforderliche Member	Membertyp	Hinweise
CanSelectMultiple	Eigenschaft	Keine
IsSelectionRequired	Eigenschaft	Keine
GetSelection	Methode	Keine
InvalidatedEvent	Ereignis	Wird ausgelöst, wenn eine Auswahl in einem Container erheblich geändert wurde und mehr ElementSelectedEvent- und ElementRemovedFromSelectionEvent-Ereignisse gesendet werden müssen, als die InvalidateLimit-Konstante zulässt.

Wenn das Ergebnis eines Select, AddToSelection oder RemoveFromSelection ein einzelnes ausgewähltes Element ist, sollte ein ElementSelectedEvent ausgelöst werden. Senden Sie andernfalls gegebenenfalls ElementAddedToSelectionEvent/ ElementRemovedFromSelectionEvent.

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp	Bedingung
InvalidOperationException	Wenn versucht wird, einen der folgenden Vorgänge auszuführen: RemoveFromSelection wird auf einem Einzelauswahlcontainer aufgerufen, für den IsSelectionRequiredProperty = true gilt und ein Element bereits ausgewählt wurde. RemoveFromSelection wird auf einem Mehrfachauswahlcontainer aufgerufen, für den IsSelectionRequiredProperty = true gilt und ein einzelnes Element bereits ausgewählt wurde. AddToSelection wird auf einem Einzelauswahlcontainer aufgerufen, für den CanSelectMultipleProperty = false gilt und ein weiteres Element bereits ausgewählt wurde.

InvalidOperationException

Wenn versucht wird, einen der folgenden Vorgänge auszuführen:

RemoveFromSelection wird auf einem Einzelauswahlcontainer aufgerufen, für den IsSelectionRequiredProperty = true gilt und ein Element bereits ausgewählt wurde.
RemoveFromSelection wird auf einem Mehrfachauswahlcontainer aufgerufen, für den IsSelectionRequiredProperty = true gilt und ein einzelnes Element bereits ausgewählt wurde.
AddToSelection wird auf einem Einzelauswahlcontainer aufgerufen, für den CanSelectMultipleProperty = false gilt und ein weiteres Element bereits ausgewählt wurde.