LVM_SETIMAGELIST message

Assigns an image list to a list-view control. You can send this message explicitly or by using the ListView_SetImageList macro.

Parameters

wParam

Type of image list. This parameter can be one of the following values:

Value Meaning
LVSIL_NORMAL
Image list with large icons.
LVSIL_SMALL
Image list with small icons.
LVSIL_STATE
Image list with state images.
LVSIL_GROUPHEADER
Image list for group header.

lParam

Handle to the image list to assign.

Return value

Returns the handle to the 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 2003 [desktop apps only]
Header
Commctrl.h