實作 UI 自動化 Toggle 控制項模式

注意事項
這份文件適用於想要使用 System.Windows.Automation 命名空間中定義之 Managed UI Automation 類別的 .NET Framework 開發人員。如需 UI Automation 的最新資訊，請參閱 Windows Automation API：使用者介面自動化 (英文)。

本主題將介紹實作 IToggleProvider 的方針和慣例，包括方法和屬性的相關資訊。其他參考的連結列於此主題的結尾部分。

TogglePattern 控制項模型是用來支援可循環顯示一組狀態，並在設定之後維持狀態的控制項。如需實作此控制項模式的控制項範例，請參閱 UI 自動化用戶端的控制項模式對應。

這個主題包含下列章節。

實作方針和慣例

實作 Toggle 控制項模式時，請注意下列方針和慣例：

若控制項在啟動後不會維持狀態，如按鈕、工具列按鈕和超連結，則必須改為實作 IInvokeProvider。
控制項必須以下列順序循環其 ToggleState：On、Off 以及 Indeterminate (若支援的話)。
TogglePattern 不提供 SetState(newState) 方法，因為直接設定三種狀態的核取方塊，而不依適當的 ToggleState 順序循環時會發生問題。
RadioButton 控制項不會實作 IToggleProvider，因為它無法循環其有效狀態。