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:
- 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 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. |
- Wenn das Ergebnis von Select, AddToSelectionoder RemoveFromSelection ein einzelnes ausgewähltes Element ist, muss ein ElementSelectedEvent ausgelöst werden. Andernfalls senden Sie entsprechend ElementAddedToSelectionEvent/ ElementRemovedFromSelectionEvent .
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
- Ü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
- Übersicht über die Benutzeroberflächenautomatisierungs-Struktur
- Verwenden der Zwischenspeicherung in der Benutzeroberflächenautomatisierung
- Beispiel für einen Fragmentanbieter