Umschalten des Steuerelementmusters

Beschreibt Richtlinien und Konventionen für die Implementierung von IToggleProvider,einschließlich Informationen zu Eigenschaften und Methoden. Das Toggle-Steuerelementmuster wird verwendet, um Steuerelemente zu unterstützen, die einen Satz von Zuständen durchlaufen und einen Zustand nach der Festlegung beibehalten können.

Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und deren unterstützte Steuerelementmuster.

Dieses Thema enthält folgende Abschnitte:

Implementierungsrichtlinien und -konventionen

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

  • Steuerelemente, die den Zustand bei Aktivierung nicht beibehalten, z. B. Schaltflächen, Symbolleistenschaltflächen und Links, müssen stattdessen IInvokeProvider implementieren.
  • Ein Steuerelement muss seine Umschaltzustände (ToggleState) in der folgenden Reihenfolge durchlaufen: ToggleState _ On, ToggleState _ Off und, falls unterstützt, ToggleState _ Unbestimmt.
  • Toggle stellt aufgrund von Problemen im Zusammenhang mit der direkten Einstellung eines Kontrollkästchens mit drei Zuständen keine Set-State-Methode bereit, ohne die entsprechende ToggleState-Sequenz zu durchlaufen.
  • Das Optionsfeld-Steuerelement implementiert IToggleProvidernicht, da es seine gültigen Zustände nicht durchlaufen kann.

Erforderliche Member für IToggleProvider

Die folgenden Eigenschaften und Methoden sind für die Implementierung der IToggleProvider-Schnittstelle erforderlich.

Erforderliche Member Memberart Hinweise
Ein-/Ausschalten Methode Keine
Togglestate Eigenschaft Keine

Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.

Steuerelementtypen und deren unterstützte Steuerelementmuster

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur