LVM_SETGROUPINFO消息

设置组信息。 显式发送此消息,或使用 ListView_SetGroupInfo 宏发送。

参数

wParam [in]

指定要设置其信息的组的 ID。

lParam [in, out]

指向包含要设置的信息的 LVGROUP 结构的指针。

返回值

如果成功,返回组的 ID,否则返回 -1。

注解

若要更改现有组的组 ID,请将 LVGF_GROUPID 添加到 LVGROUP.mask ,并将 LVGROUP.iGroupId 设置为新 ID。 如果 LVGROUP.iGroupId 包含现有组的 ID,则调用将失败。

若要更新现有组的其他属性 (例如更新组的页眉或页脚文本的对齐方式, uAlign) LVGROUP.mask 不得包含 LVGF_GROUPID,否则更新将失败。

注意

若要使用此消息,必须提供一个清单,指定Comclt32.dll版本 6.0。 有关清单的详细信息,请参阅 启用视觉样式

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
标头
Commctrl.h