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 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
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista [desktop apps only] |
| Minimum supported server |
Windows Server 2003 [desktop apps only] |
| Header |
|