TVM_SETIMAGELIST message

Sets the normal or state image list for a tree-view control and redraws the control using the new images. You can send this message explicitly or by using the TreeView_SetImageList macro.

Parameters

wParam

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

Value Meaning
TVSIL_NORMAL
Indicates the normal image list, which contains selected, nonselected, and overlay images for the items of a tree-view control.
TVSIL_STATE
Indicates the state image list. You can use state images to indicate application-defined item states. A state image is displayed to the left of an item's selected or nonselected image.

lParam

Handle to the image list. If lParam is NULL, the message removes the specified image list from the tree-view control.

Return value

Returns the handle to the previous image list, if any, or NULL otherwise.

Remarks

The tree-view control will not destroy the image list specified with this message. Your application must destroy the image list when it is no longer needed.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Commctrl.h

See also

TVM_GETIMAGELIST