组 (Windows 功能区框架)
组在 选项卡中组织相关的命令和控件。
详细信息
以下屏幕截图演示了功能区组控件。
组属性
功能区框架定义 Group 控件 的属性键 集合。
通常,通过调用 IUIFramework::InvalidateUICommand 方法使与控件关联的命令失效,从而在功能区 UI 中更新 Group 属性。 无效事件由 IUICommandHandler::UpdateProperty 回调方法处理,并更新定义的属性。
IUICommandHandler::UpdateProperty 回调方法不会执行,应用程序会查询更新的属性值,直到框架需要该属性。 例如,在功能区 UI 中激活选项卡和显示控件时,或显示工具提示时。
注意
在某些情况下,可以通过 IUIFramework::GetUICommandProperty 方法检索属性,并使用 IUIFramework::SetUICommandProperty 方法进行设置。
下表列出了与 Group 控件关联的属性键。
属性键 | 注释 |
---|---|
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 | 只能通过失效进行更新。 |