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.

In diesem Thema werden Richtlinien und Konventionen für die Implementierung von ISelectionItemProvidervorgestellt, einschließlich Informationen zu Eigenschaften, Methoden und Ereignissen. Links zu zusätzlichen Verweisen werden am Ende der Übersicht aufgeführt.

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 Steuerelementmusterzuordnung für Benutzeroberflächenautomatisierungs-Clients.

Implementierungsrichtlinien und -konventionen

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

• Steuerelemente mit Einfachauswahl, die untergeordnete Steuerelemente verwalten, die IRawElementProviderFragmentRootimplementieren, z. B. der Bildschirmauflösung -Schieberegler im Dialogfeld Anzeigeeigenschaften , sollten ISelectionProvider implementieren. Deren untergeordnete Elemente sollten sowohl IRawElementProviderFragment als auch ISelectionItemProviderimplementieren.

Erforderliche Mitglieder für ISelectionItemProvider

Für die Implementierung von ISelectionItemProvidersind die folgenden Eigenschaften, Methoden und Ereignisse erforderlich.

Erforderliche Member	Memberart	Notizen
IsSelected	Eigenschaft	Keine
SelectionContainer	Eigenschaft	Keine
AddToSelection	Methode	Keine
RemoveFromSelection	Methode	Keine
Select	Methode	Keine
ElementSelectedEvent	Ereignis	Wird ausgelöst, wenn eine Auswahländerung zu einem einzelnen ausgewählten Element führt.
ElementAddedToSelectionEvent	Ereignis	Wird ausgelöst, wenn einem Container mit mehrfacher Auswahl ein Element hinzugefügt wird.
ElementRemovedFromSelectionEvent	Ereignis	Wird ausgelöst, wenn ein Element aus einem Mehrfachauswahlcontainer entfernt wird.
InvalidatedEvent	Ereignis	Wird ausgelöst, wenn sich eine Auswahl in einem Container erheblich geändert hat und mehr ElementSelectedEvent- und ElementRemovedFromSelectionEvent-Ereignisse gesendet werden müssen, als die InvalidateLimit-Konstante zulässt.

• Wenn ein Select-, AddToSelection- oder RemoveFromSelection-Vorgang zu einem einzelnen ausgewählten Element führt, heben Sie ElementSelectedEvent; andernfalls heben Sie ElementAddedToSelectionEvent oder ElementRemovedFromSelectionEvent entsprechend an.

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp

Bedingung

InvalidOperationException

Wenn eine der folgenden Versuche versucht wird: - RemoveFromSelection wird für einen Einzelauswahlcontainer aufgerufen, in dem IsSelectionRequiredProperty = true und bereits ein Element ausgewählt ist. - RemoveFromSelection wird für einen Mehrfachauswahlcontainer aufgerufen, in dem IsSelectionRequiredProperty = true und nur ein Element ausgewählt ist. - AddToSelection wird für einen Einzelauswahlcontainer aufgerufen, in dem CanSelectMultipleProperty = false und ein anderes Element bereits ausgewählt ist.

Weitere Informationen

• Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung
• Unterstützung von Steuerelementmustern in einem Benutzeroberflächenautomatisierungs-Anbieter
• Steuerelementmuster für Benutzeroberflächenautomatisierung für Clients
• Implementieren des Selection-Steuerelementmusters der Benutzeroberflächenautomatisierung
• UI-Automatisierungsstruktur Übersicht
• Verwenden der Zwischenspeicherung in der Benutzeroberflächenautomatisierung
• Fragmentanbieterbeispiel