Windows Dev Center

Expand Minimize

ListView_SetImageList macro

Assigns an image list to a list-view control. You can use this macro or send the LVM_SETIMAGELIST message explicitly.

Syntax


HIMAGELIST ListView_SetImageList(
   HWND       hwnd,
   HIMAGELIST himl,
   int        iImageList
);

Parameters

hwnd

Type: HWND

A handle to the list-view control.

himl

Type: HIMAGELIST

A handle to the image list to assign.

iImageList

Type: int

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

ValueMeaning
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.

 

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

 

 

Community Additions

ADD
Show:
© 2015 Microsoft