Expand Minimize

TreeView_SetImageList macro

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

Syntax


HIMAGELIST TreeView_SetImageList(
  HWND hwndTV,
  HIMAGELIST himl,
  INT iImage
);

Parameters

hwndTV

Type: HWND

Handle to the tree-view control.

himl

Type: HIMAGELIST

The HIMAGELIST handle to the image list. If himl is NULL, the message removes the specified image list from the tree-view control.

iImage

Type: INT

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

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

 

Return value

Returns the HIMAGELIST 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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Commctrl.h

See also

Reference
TreeView_GetImageList
TVM_GETIMAGELIST

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.