Implementieren des Toggle-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 IToggleProvider vorgestellt sowie Methoden und Eigenschaften erläutert. Am Ende des Themas finden Sie Links zu zusätzlichen Verweisen.

Das TogglePattern Steuerelementmuster dient zur Unterstützung von Steuerelementen, die eine Reihe von Zuständen durchlaufen und einen einmal festgelegten Zustand beibehalten können. 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 IToggleProvider
Ausnahmen
Verwandte Abschnitte

Implementierungsrichtlinien und Konventionen

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

Für Steuerelemente, die nach Aktivierung den Zustand nicht beibehalten (z. B. Schaltflächen, Symbolleistenschaltflächen und Links), muss stattdessen IInvokeProvider implementiert werden.
Der ToggleState eines Steuerelements muss in der folgenden Reihenfolge durchlaufen werden: On, Off und, falls unterstützt, Indeterminate.
TogglePattern stellt keine SetState(newState)-Methode zur Verfügung. Dies ist auf Probleme zurückzuführen, die beim direkten Festlegen einer CheckBox mit dreifachem Zustand auftreten, da hierbei die entsprechende ToggleState-Sequenz nicht durchlaufen wird.
Für das RadioButton-Steuerelement ist kein IToggleProvider implementiert, da dessen gültige Zustände nicht durchlaufen werden können.