Freigeben über

Implementieren des Toggle-Steuerelementmusters der Benutzeroberflächenautomatisierung

  • Artikel

Hinweis

Diese Dokumentation ist für .NET Framework-Entwickler konzipiert, die die verwalteten Klassen zur Automatisierung der Benutzeroberfläche verwenden möchten, die im Namespace System.Windows.Automation definiert sind. Aktuelle Informationen zur Automatisierung der Benutzeroberfläche finden Sie auf der Seite zur Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.

Dieses Thema enthält Richtlinien und Konventionen zum Implementieren von IToggleProvider, einschließlich Informationen über Methoden und Eigenschaften. Links zu zusätzlichen Referenzen sind am Ende dieses Themas aufgelistet.

Das TogglePattern -Steuerelementmuster dient zur Unterstützung von Steuerelementen, die eine Reihe von Zuständen durchlaufen und einen Zustand beibehalten, nachdem dieser festgelegt wurde. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Control Pattern Mapping for UI Automation Clients.

Implementierungsrichtlinien und -konventionen

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

  • Steuerelemente, die ihren Zustand nach der Aktivierung nicht beibehalten, z. B. Schaltflächen, Symbolleistenschaltflächen und Links, müssen stattdessen IInvokeProvider implementieren.

  • Ein Steuerelement muss seinen ToggleState in der folgenden Reihenfolge durchlaufen: On, Off und Indeterminate(sofern unterstützt).

  • TogglePattern bietet aufgrund der Probleme im Rahmen der direkten Einstellung eines CheckBox-Steuerelements mit drei Zuständen ohne Durchlaufen seiner entsprechenden ToggleState -Sequenz keine „SetState(newState)“-Methode.

  • Das RadioButton-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 das Implementieren von IToggleProvidererforderlich.

Erforderlicher Member Memberart Hinweise
Toggle Methode Keine
ToggleStateProperty Eigenschaft Keine

Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.

Ausnahmen

Diesem Steuerelementmuster sind keine Ausnahmen zugeordnet.

Weitere Informationen