實作 UI 自動化 Toggle 控制項模式
注意
本文件適用對象為 .NET Framework 開發人員，其想要使用 System.Windows.Automation 命名空間中定義的受控 UI 自動化類別。 如需 UI 自動化的最新資訊，請參閱 Windows 自動化 API：UI 自動化。
本主題將介紹實作 IToggleProvider的方針和慣例，包括方法和屬性的相關資訊。 其他參考的連結列於此主題的結尾部分。
TogglePattern 控制項模式是用來支援可循環顯示一組狀態，並在設定之後維持狀態的控制項。 如需實作此控制項模式的控制項範例，請參閱 Control Pattern Mapping for UI Automation Clients。
實作方針和慣例
實作切換控制項模式時，請注意下列方針和慣例：
若控制項在啟動後不會維持狀態，如按鈕、工具列按鈕和超連結，則必須改為實作 IInvokeProvider 。
控制項必須以下列順序循環其 ToggleState ： On、 Off 以及 Indeterminate(若支援的話)。
TogglePattern 不提供 SetState(newState) 方法，因為直接設定三種狀態的核取方塊，而不依適當的 ToggleState 順序循環時會發生問題。
RadioButton 控制項不會實作 IToggleProvider，因為它無法循環其有效狀態。
IToggleProvider 的必要成員
以下是實作 IToggleProvider的必要屬性和方法。
| 必要成員 | 成員類型 | 備註 |
|---|---|---|
| Toggle | 方法 | 無 |
| ToggleStateProperty | 屬性 | 無 |
此控制項模式沒有任何相關聯的事件。
例外狀況
此控制項模式沒有任何相關聯的例外狀況。