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
- Erforderliche Member für IToggleProvider
- Zugehörige Themen
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.