Edit

Share via

ListView_SetGroupState macro (commctrl.h)

  • Article

Sets the state for a specified group.

Syntax

LRESULT ListView_SetGroupState(
  [in] HWND hwnd,
  [in] UINT dwGroupId,
  [in] UINT dwMask,
  [in] UINT dwState
);

Parameters

[in] hwnd

Type: HWND

A handle to the list-view control.

[in] dwGroupId

Type: UINT

Specifies the group by iGroupId (see LVGROUP structure).

[in] dwMask

Type: UINT

Specifies the state values to set or clear. This is a combination of the flags listed for the state member of LVGROUP.

[in] dwState

Type: UINT

Specifies the state values to set. States that are not included here but are included in dwMask are cleared.

Return value

Type: LRESULT

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

Remarks

Note  To use this macro, you must provide a manifest specifying Comctl32.dll version 6.0. For more information on manifests, see Enabling Visual Styles.
 
You can also set the group state by using ListView_SetGroupInfo.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header commctrl.h