In-Ribbon 資源庫
In-Ribbon 資源庫是顯示功能區中相關專案或命令集合的控制項。 如果資源庫中有太多專案,則會提供展開箭號,以在展開的窗格中顯示集合的其餘部分。
詳細資料
下列螢幕擷取畫面說明 Microsoft 小畫家 中的功能區 In-Ribbon 資源庫控制項。
In-Ribbon 資源庫屬性
功能區架構會定義 In-Ribbon 資源庫控制項 的屬性索引鍵 集合。
一般而言,In-Ribbon Gallery 屬性會在功能區 UI 中更新,方法是透過 呼叫 IUIFramework::InvalidateUICommand 方法,使與控制項相關聯的 Command 失效。 會處理無效事件,以及 IUICommandHandler::UpdateProperty 回呼方法所定義的屬性更新。
不會執行 IUICommandHandler::UpdateProperty回呼方法,而且應用程式會查詢更新的屬性值,直到架構需要屬性為止。 例如,當索引標籤啟動時,以及功能區 UI 中顯示的控制項,或顯示工具提示時。
注意
在某些情況下,可以透過 IUIFramework::GetUICommandProperty 方法擷取屬性,並使用 IUIFramework::SetUICommandProperty 方法進行設定。
下表列出與資源庫控制項 In-Ribbon 相關聯的屬性索引鍵。
屬性索引鍵 | 備註 |
---|---|
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 | 只能透過失效來更新。 |