核取方塊

核取方塊是使用者可以按一下以提供輸入給應用程式的控制項。控制項提供以視覺化方式表示的切換狀態。

詳細資料

核取方塊不支援第三個或不確定的狀態。

下列螢幕擷取畫面說明功能區核取方塊元素。

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	只能透過失效來更新。