Freigeben über


Implementieren des SelectionItem-Steuerelementmusters der Benutzeroberflächenautomatisierung

Hinweis

Diese Dokumentation ist für .NET Framework-Entwickler konzipiert, die die verwalteten Klassen zur Automatisierung der Benutzeroberfläche verwenden möchten, die im Namespace System.Windows.Automation definiert sind. Aktuelle Informationen zur Automatisierung der Benutzeroberfläche finden Sie auf der Seite zur Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.

Dieses Thema enthält Richtlinien und Konventionen für das Implementieren von ISelectionItemProvider, einschließlich Informationen über Eigenschaften, Methoden und Ereignissen. Links zu zusätzlichen Referenzen sind am Ende dieser Übersicht aufgelistet.

Das SelectionItemPattern -Steuerelementmuster dient zur Unterstützung von Steuerelementen, die als einzelne auswählbare untergeordnete Elemente von Containersteuerelementen fungieren, die ISelectionProviderimplementieren. Beispiele für Steuerelemente, die das SelectionItem-Steuerelementmuster implementieren, finden Sie unter Zuordnen von Steuerelementmustern für Benutzeroberflächenautomatisierungs-Clients.

Implementierungsrichtlinien und -konventionen

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

Erforderliche Member für ISelectionItemProvider

Die folgenden Eigenschaften, Methoden und Ereignisse sind für die ISelectionItemProvider-Implementierung erforderlich.

Erforderliche Member Memberart Hinweise
CanSelectMultiple Eigenschaft Keine
IsSelectionRequired Eigenschaft Keine
GetSelection Methode Keine
InvalidatedEvent Ereignis Dieses wird ausgelöst, wenn die Auswahl in einem Container maßgeblich geändert wurde und dies das Senden weiterer ElementSelectedEvent - und ElementRemovedFromSelectionEvent -Ereignisse erfordert, als die InvalidateLimit -Konstante gestattet.

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp Bedingung
InvalidOperationException Wenn einer der folgenden Schritte versucht wird:

- RemoveFromSelection wird für einen Einfachauswahlcontainer aufgerufen, für den IsSelectionRequiredProperty = true gilt und bereits ein Element ausgewählt ist.
- RemoveFromSelection wird für einen Mehrfachauswahlcontainer aufgerufen, für den IsSelectionRequiredProperty = true gilt und nur ein Element ausgewählt ist.
- AddToSelection wird für einen Einfachauswahlcontainer aufgerufen, für den CanSelectMultipleProperty = false gilt und bereits ein weiteres Element ausgewählt ist.

Weitere Informationen