Edit

Share via

LVM_SETIMAGELIST message

  • Article

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