Freigeben über


Implementieren des Toggle-Steuerelementmusters der Benutzeroberflächenautomatisierung

HinweisHinweis

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.

Erforderliche Member für IToggleProvider

Zum Implementieren von IToggleProvider werden die folgenden Eigenschaften und Methoden benötigt.

Erforderliche Member

Membertyp

Hinweise

Toggle

Methode

Keine

ToggleStateProperty

Eigenschaft

Keine

Dieses Steuerelementmuster verfügt über keine zugeordneten Ereignisse.

Ausnahmen

Dieses Steuerelementmuster beinhaltet keine zugeordneten Ausnahmen.

Siehe auch

Aufgaben

Unterstützung von Steuerelementmustern in einem Benutzeroberflächenautomatisierungs-Anbieter

Abrufen des Umschaltstatus eines Kontrollkästchens mithilfe von Benutzeroberflächenautomatisierung

Verwenden der Zwischenspeicherung in der Benutzeroberflächenautomatisierung

Konzepte

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Steuerelementmuster für Benutzeroberflächenautomatisierung für Clients

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur