Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
TreeView_SetImageList macro (commctrl.h)
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 hwnd,
HIMAGELIST himl,
INT iImage
);
Parameters
hwnd
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:
| Value | Meaning |
|---|---|
|
Indicates the normal image list, which contains selected, nonselected, and overlay images for the items of a tree-view control. |
|
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
Type: HIMAGELIST
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | commctrl.h |
See also
Reference
Feedback
Was this page helpful?