群組（Windows 功能區架構）

詳

下列螢幕快照說明功能區群組控件。

顯示群組圖說文字的螢幕快照。

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

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

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

注意

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

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

屬性索引鍵	筆記
UI_PKEY_Keytip	只能透過無效更新。注意：架構要求群組控件的 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	只能透過無效更新。