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