切換按鈕

按一下時，切換按鈕會提供應用程式的輸入。控制項代表互斥切換狀態。

詳細資料

下列螢幕擷取畫面說明功能區切換按鈕。

microsoft paint 功能區中切換按鈕控制項的螢幕擷取畫面。

功能區架構會定義切換按鈕控制項的屬性索引鍵集合。

一般而言，切換按鈕屬性會在功能區 UI 中更新，方法是透過呼叫 IUIFramework：：InvalidateUICommand 方法，使與控制項相關聯的命令失效。無效事件是由 IUICommandHandler：：UpdateProperty 回呼方法所定義的屬性更新處理。

IUICommandHandler：：UpdateProperty回呼方法不會執行，而且應用程式會查詢更新的屬性值，直到架構需要屬性為止。例如，當索引標籤啟動時，以及功能區 UI 中顯示的控制項，或顯示工具提示時。

注意

在某些情況下，可以透過 IUIFramework：：GetUICommandProperty 方法擷取屬性，並使用 IUIFramework：：SetUICommandProperty 方法進行設定。

下表列出與切換按鈕控制項相關聯的屬性鍵。

屬性索引鍵	備註
UI_PKEY_BooleanValue	支援 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。注意：如果與控制項相關聯的命令透過對 IUIFramework：：InvalidateUICommand的呼叫失效，則當傳遞為旗標的值時 `UI_INVALIDATIONS_VALUE` ，架構會查詢此屬性。
UI_PKEY_Enabled	支援 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。
UI_PKEY_Keytip	只能透過失效來更新。
UI_PKEY_Label	只能透過失效來更新。
UI_PKEY_LabelDescription	只能透過失效來更新。
UI_PKEY_LargeHighContrastImage	只能透過失效來更新。
UI_PKEY_LargeImage	只能透過失效來更新。
UI_PKEY_SmallHighContrastImage	只能透過失效來更新。
UI_PKEY_SmallImage	只能透過失效來更新。
UI_PKEY_TooltipDescription	只能透過失效來更新。
UI_PKEY_TooltipTitle	只能透過失效來更新。