群組 (Windows 功能區架構)

群組會組織索引卷標內相關的命令和控制項。

詳細資料

下列螢幕擷取畫面說明功能區群組控制項。

顯示群組的圖說文字螢幕擷取畫面。

功能區架構會定義群組控制項的屬性索引鍵集合。

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

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

注意

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

下表列出與群組控制項相關聯的屬性索引鍵。

屬性索引鍵	備註
UI_PKEY_Keytip	只能透過失效來更新。注意：架構要求 Group 控制項的 UI_PKEY_Keytip 值是以大寫字母 Z 開頭。如果應用程式在 IUICommandHandler：：UpdateProperty 回呼方法中所提供的值不是以字母 Z 開頭，則會忽略此值，並改為由架構產生值。架構值是字母 Z，後面接著從 1 開始的數值，並視需要依序遞增，後續的 Group 控制項 (Z1、Z2、...、Zx) 。
UI_PKEY_Label	只能透過失效來更新。
UI_PKEY_LargeHighContrastImage	只能透過失效來更新。
UI_PKEY_LargeImage	只能透過失效來更新。
UI_PKEY_SmallHighContrastImage	只能透過失效來更新。
UI_PKEY_SmallImage	只能透過失效來更新。
UI_PKEY_TooltipDescription	只能透過失效來更新。
UI_PKEY_TooltipTitle	只能透過失效來更新。