共用方式為


Drop-Down 資源庫

Drop-Down 資源庫包含按鈕,當按一下時,會顯示包含互斥專案或命令集合的下拉式清單。

詳細資料

此控制項適用于公開沒有明顯預設值的相關專案或命令,而且個別專案可以由影像、文字或兩者表示。

透過 DropDownGallery.MenuLayout 元素提供垂直和角落控點或調整大小控點的支援。

下列螢幕擷取畫面說明 Microsoft 小畫家 中的功能區 Drop-Down 資源庫。

microsoft paint 功能區中下拉式清單控制項的螢幕擷取畫面。

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

一般而言,Drop-Down 資源庫屬性會透過呼叫 IUIFramework::InvalidateUICommand 方法,在功能區 UI 中更新與控制項相關聯的命令。 無效事件是由 IUICommandHandler::UpdateProperty 回呼方法所定義的屬性更新處理。

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

注意

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

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

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

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

DropDownGallery 標記專案

使用資源庫

資源庫範例