LVM_SETGROUPINFO message

Sets group information. Send this message explicitly or by using the ListView_SetGroupInfo macro.

Parameters

wParam [in]

ID that specifies the group whose information is to be set.

lParam [in, out]

Pointer to a [**LVGROUP**](windows/win32/api/commctrl/ns-commctrl-lvgroup) structure that contains the information to set.

Return value

Returns the ID of the group if successful, or -1 otherwise.

Remarks

To change a group ID of an existing group add LVGF_GROUPID to LVGROUP.mask and set LVGROUP.iGroupId to the new ID. The call will fail if LVGROUP.iGroupId contains ID of an existing group.

To update other properties of an existing group (e.g. update an alignment of the header or footer text for the group, uAlign) LVGROUP.mask must not contain LVGF_GROUPID, else the update will fail.

Note

To use this message, you must provide a manifest specifying Comclt32.dll version 6.0. For more information on manifests, see Enabling Visual Styles.

Requirements

Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Commctrl.h