Freigeben über

Implementieren des Toggle-Steuerelementmusters der Benutzeroberflächenautomatisierung

Hinweis

Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Windows Automation API: Benutzeroberflächenautomatisierung.

In diesem Thema werden Richtlinien und Konventionen für die Implementierung IToggleProvidervorgestellt, einschließlich Informationen zu Methoden und Eigenschaften. Links zu zusätzlichen Referenzen sind am Ende dieses Themas aufgelistet.

Das TogglePattern Steuerelementmuster wird verwendet, um Steuerelemente zu unterstützen, die einen Satz von Zuständen durchlaufen und einen Zustand nach dem Festlegen beibehalten können. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementmusterzuordnung für Benutzeroberflächenautomatisierungs-Clients.

Implementierungsrichtlinien und -konventionen

Beachten Sie bei der Implementierung des Umschaltsteuerungsmusters die folgenden Richtlinien und Konventionen:

  • Steuerelemente, die den Zustand nicht beibehalten, wenn sie aktiviert werden, z. B. Schaltflächen, Symbolleistenschaltflächen und Links, müssen stattdessen implementiert werden IInvokeProvider .

  • 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 IToggleProvider nicht, da es nicht in der Lage ist, zwischen seinen gültigen Zuständen zu wechseln.

Erforderliche Mitglieder für IToggleProvider

Die folgenden Eigenschaften und Methoden sind für das Implementieren von IToggleProvidererforderlich.

Erforderlicher Member Memberart Hinweise
Toggle Methode Nichts
ToggleStateProperty Eigentum Nichts

Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.

Ausnahmen

Diesem Steuerelementmuster sind keine Ausnahmen zugeordnet.

Siehe auch

  • Last updated on