切換控制項模式

  • 發行項

描述實作 IToggleProvider的指導方針和慣例，包括屬性和方法的相關資訊。 切換控制項模式可用來支援可迴圈一組狀態並維護一次設定狀態的控制項。

如需實作此控制項模式的控制項範例，請參閱 控制項類型及其支援的控制項模式。

本主題包含下列各節。

實作方針和慣例

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

  • 啟動時不會維護狀態的控制項，例如按鈕、工具列按鈕和超連結，必須改為實作 IInvokeProvider 。
  • 控制項必須依下列順序迴圈流覽其切換狀態 (ToggleState) ： ToggleState_On、 ToggleState_Off ，以及 ToggleState_Indeterminate。
  • Toggle 不會提供 set-state 方法，因為三個狀態核取方塊的直接設定發生問題，而不會迴圈流覽其適當的 ToggleState 序列。
  • 選項按鈕控制項不會實作 IToggleProvider，因為它無法透過其有效狀態迴圈。

IToggleProvider的必要成員

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

必要成員 成員類型 備註
切換 方法 無
ToggleState 屬性 無

 

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

控制項類型及其支援的控制項模式

UI 自動化控制項模式概觀

UI 自動化樹狀目錄概觀