ListView_GetGroupState macro

Gets the state for a specified group. Use this macro or send the LVM_GETGROUPSTATE message explicitly.


UINT ListView_GetGroupState(
  [in] HWND hwnd,
  [in] UINT dwGroupId,
  [in] UINT dwMask


hwnd [in]

Type: HWND

A handle to the list-view control.

dwGroupId [in]

Type: UINT

Specifies the group by iGroupId (see LVGROUP structure).

dwMask [in]

Type: UINT

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

Return value

Returns the combination of state values that are set. For example, if dwMask is LVGS_COLLAPSED and the value returned is zero, the LVGS_COLLAPSED state is not set. Zero is returned if the group is not found.


Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]