分割按鈕庫

[分割按鈕庫] 是一個複合控制項，其中包含一個主要按鈕，其中會公開單一預設專案或 Command，而次要按鈕會在按一下時，在互斥的下拉式清單中顯示專案的其餘部分或 Command 集合。

詳細資料

如果有明顯的預設值可用，以及個別專案可以透過影像、文字或兩者來表示，這個控制項對於公開密切相關的專案很有用。

下列螢幕擷取畫面說明Microsoft 小畫家中的功能區分割按鈕庫。

microsoft paint 功能區中 splitbutbutallery 控制項的螢幕擷取畫面。

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

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

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

注意

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

下表列出與分割按鈕庫控制項相關聯的屬性索引鍵。

屬性索引鍵	備註
UI_PKEY_BooleanValue	支援 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。
UI_PKEY_Categories	支援 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。
UI_PKEY_Enabled	支援 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。
UI_PKEY_ItemsSource	支援 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。
UI_PKEY_Keytip	只能透過失效來更新。
UI_PKEY_Label	只能透過失效來更新。
UI_PKEY_LargeHighContrastImage	只能透過失效來更新。
UI_PKEY_LargeImage	只能透過失效來更新。
UI_PKEY_SelectedItem (僅適用于專案庫)	支援 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。注意：如果透過呼叫 IUIFramework：：InvalidateUICommand使與控制項相關聯的命令失效，架構會在傳遞為旗標的值時 `UI_INVALIDATIONS_VALUE` 查詢此屬性。
UI_PKEY_SmallHighContrastImage	只能透過失效來更新。
UI_PKEY_SmallImage	只能透過失效來更新。
UI_PKEY_TooltipDescription	只能透過失效來更新。
UI_PKEY_TooltipTitle	只能透過失效來更新。