分割按鈕庫

分割按鈕庫是一個複合控件，其中包含公開單一默認專案或 Command 的主要按鈕，以及按兩下時按兩下的次要按鈕會在互斥的下拉式清單中顯示專案或 Command 集合的其餘部分。

詳

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

下列螢幕快照說明 Microsoft Paint 中的功能區分割按鈕庫。

microsoft paint 功能區中 splitbuttongallery 控件的螢幕快照。

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

一般而言，分割按鈕庫屬性會在功能區 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	只能透過無效更新。