Split Button

分割按鈕是複合控制項，使用者可以選取系結至主要按鈕的預設值，或從系結至次要按鈕的下拉式清單中顯示的互斥值清單中選取。

簡介

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

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

範例功能區中分割按鈕控制項的螢幕擷取畫面。

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

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

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

注意

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

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

屬性索引鍵	備註
UI_PKEY_Enabled	支援 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。如果停用所有子專案，架構會將UI_PKEY_Enabled 設定為 false (0) 。否則，如果啟用一或多個子專案，UI_PKEY_Enabled會設定為 true (-1) 。重要：啟用或停用一或多個子專案之後，分割按鈕控制項的 UI_PKEY_Enabled 屬性應該失效。這可確保架構會查詢更新的屬性值，並重新整理功能區 UI 中分割按鈕控制項的狀態。
UI_PKEY_Keytip	只能透過失效來更新。
UI_PKEY_TooltipDescription	只能透過失效來更新。
UI_PKEY_TooltipTitle	只能透過失效來更新。