Drop-Down 按鈕

  • 發行項

Drop-Down Button 是由按一下時顯示互斥專案的下拉式清單的按鈕所組成。

詳細資料

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

下列螢幕擷取畫面說明範例功能區中的功能區 Drop-Down 按鈕。

範例功能區中下拉式按鈕控制項的螢幕擷取畫面。

功能區架構會定義 Drop-Down Button 控制項 的屬性索引鍵 集合。

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

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

注意

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

下表列出與 Drop-Down Button 控制項相關聯的屬性索引鍵。

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

Windows 功能區架構控制項程式庫

DropDownButton 標記專案