Freigeben über

Steuerelementmuster umschalten

  • Artikel

Beschreibt Richtlinien und Konventionen für die Implementierung von IToggleProvider, einschließlich Informationen zu Eigenschaften und Methoden. Das Umschalter-Steuerelementmuster wird verwendet, um Steuerelemente zu unterstützen, die durch eine Reihe von Zuständen wechseln und einen zustand beibehalten können, nachdem festgelegt wurde.

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 bei der Implementierung des Umschalter-Steuerelementmusters die folgenden Richtlinien und Konventionen:

  • Steuerelemente, die bei Aktivierung keinen Zustand beibehalten, z. B. Schaltflächen, Symbolleistenschaltflächen und Hyperlinks, 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_Indeterminate.
  • Das Umschalten bietet keine Set-State-Methode aufgrund von Problemen im Zusammenhang mit der direkten Einstellung eines Kontrollkästchens mit drei Zuständen, ohne die entsprechende ToggleState-Sequenz durchlaufen zu müssen.
  • Das Optionsfeldsteuerelement implementiert IToggleProvider nicht, da es nicht in der Lage ist, den gültigen Zustand zu durchlaufen.

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