This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for

This macro creates a dragging bitmap for the specified item in a tree-view control, creates an image list for the bitmap, and adds the bitmap to the image list. An application can display the image when dragging the item by using the image list functions. You can use this macro or send the TVM_CREATEDRAGIMAGEmessage explicitly.


HIMAGELIST TreeView_CreateDragImage( 





Handle to the tree view control.


Handle to the item that receives the new dragging bitmap.

Return Value

The handle to the image list to which the dragging bitmap was added indicates success. NULL indicates failure.


If you create a tree view control without an associated image list, you cannot use the TreeView_CreateDragImagemacro to create the image to display during a drag operation. You must implement your own method of creating a drag cursor.


Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also