共用方式為


實作UI自動化切換控件模式

備註

本檔適用於想要使用 System.Windows.Automation 命名空間中定義的受控UI自動化類別的 .NET Framework 開發人員。 如需 UI 自動化的最新資訊,請參閱 Windows 自動化 API:使用者介面自動化

本主題介紹實作 IToggleProvider的指導方針和慣例,包括方法和屬性的相關信息。 主題結尾會列出其他參考的連結。

TogglePattern 控制模式用於支援能循環一組狀態並在設定後維持該狀態的控制項。 如需實作此控制項模式的控制項範例,請參閱 UI 自動化用戶端的控制項模式對應

實作指導方針和慣例

實作切換控件模式時,請注意下列指導方針和慣例:

  • 啟用時不會維護狀態的控件,例如按鈕、工具列按鈕和超連結,必須改為實作 IInvokeProvider

  • 控制項必須依下列順序循環:ToggleStateOnOff,如果支援的話,再次循環至Indeterminate

  • TogglePattern 不提供 SetState(newState) 方法,因為直接設定三狀態的核取方塊時,無法循環執行其適當的 ToggleState 順序而導致問題。

  • 單選按鈕控制元件不會實作 IToggleProvider,因為它無法循環切換到其有效狀態。

IToggleProvider 的必要成員

實作 IToggleProvider需要下列屬性和方法。

必要成員 成員類型 註釋
Toggle 方法 沒有
ToggleStateProperty 房產 沒有

此控制件模式沒有相關聯的事件。

例外狀況

此控制項模式沒有相關聯的例外狀況。

另請參閱