组 (Windows 功能区框架)

组在 选项卡中组织相关的命令和控件。

以下屏幕截图演示了功能区组控件。

显示组的标注 屏幕截图。

组属性

功能区框架定义组控件 属性键的集合。

通常,通过调用 IUIFramework::InvalidateUICommand 方法使与控件关联的命令失效,在功能区 UI 中更新组属性。 无效事件由 IUICommandHandler::UpdateProperty 回调方法处理并定义属性更新。

不会执行 IUICommandHandler::UpdateProperty 回调方法,并且应用程序会查询更新的属性值,直到框架需要该属性。 例如,当选项卡被激活,并在功能区 UI 中显示控件或显示工具提示时。

注意

在某些情况下,可以通过 IUIFramework::GetUICommandProperty 方法检索属性,并使用 IUIFramework::SetUICommandProperty 方法进行设置。

下表列出了与组控件关联的属性键。

属性键 笔记
UI_PKEY_Keytip 只能通过无效更新。 注意: 框架要求组控件的 UI_PKEY_Keytip 值以大写字母 Z 开头。如果应用程序在 IUICommandHandler::UpdateProperty 回调方法中提供的值不以字母 Z 开头,则会忽略此值,而是由框架生成值。 框架值是字母 Z,后跟从 1 开始的数值,后续组控件(Z1、Z2、...、Zx)按顺序递增。
UI_PKEY_Label 只能通过无效更新。
UI_PKEY_LargeHighContrastImage 只能通过无效更新。
UI_PKEY_LargeImage 只能通过无效更新。
UI_PKEY_SmallHighContrastImage 只能通过无效更新。
UI_PKEY_SmallImage 只能通过无效更新。
UI_PKEY_TooltipDescription 只能通过无效更新。
UI_PKEY_TooltipTitle 只能通过无效更新。

Windows 功能区框架控件库

Group 元素