備註
本檔適用於想要使用 System.Windows.Automation 命名空間中定義的受控UI自動化類別的 .NET Framework 開發人員。 如需 UI 自動化的最新資訊,請參閱 Windows 自動化 API:使用者介面自動化。
本主題介紹實作 IToggleProvider的指導方針和慣例,包括方法和屬性的相關信息。 主題結尾會列出其他參考的連結。
TogglePattern 控制模式用於支援能循環一組狀態並在設定後維持該狀態的控制項。 如需實作此控制項模式的控制項範例,請參閱 UI 自動化用戶端的控制項模式對應。
實作指導方針和慣例
實作切換控件模式時,請注意下列指導方針和慣例:
啟用時不會維護狀態的控件,例如按鈕、工具列按鈕和超連結,必須改為實作 IInvokeProvider 。
控制項必須依下列順序循環:ToggleState、On、Off,如果支援的話,再次循環至Indeterminate。
TogglePattern 不提供 SetState(newState) 方法,因為直接設定三狀態的核取方塊時,無法循環執行其適當的 ToggleState 順序而導致問題。
單選按鈕控制元件不會實作 IToggleProvider,因為它無法循環切換到其有效狀態。
IToggleProvider 的必要成員
實作 IToggleProvider需要下列屬性和方法。
| 必要成員 | 成員類型 | 註釋 |
|---|---|---|
| Toggle | 方法 | 沒有 |
| ToggleStateProperty | 房產 | 沒有 |
此控制件模式沒有相關聯的事件。
例外狀況
此控制項模式沒有相關聯的例外狀況。