ListView_SetGroupHeaderImageList macro (commctrl.h)

Article
10/23/2024

Assigns an image list to the group header of a list-view control.

Syntax

HIMAGELIST ListView_SetGroupHeaderImageList(
  [in] HWND hwnd,
  [in] HIML himl
);

Parameters

[in] hwnd

Type: HWND

A handle to the list-view control.

[in] himl

Type: HIML

A handle to the image list.

Return value

Type: HIMAGELIST

Returns the handle to the group header image list previously associated with the control if successful, or NULL otherwise.

Remarks

The current image list will be destroyed when the list-view control is destroyed unless the LVS_SHAREIMAGELISTS style is set. If you use this message to replace one image list with another, your application must explicitly destroy all image lists other than the current one.

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

Share via