Prev Next

ImageList_BeginDrag info  Overview  Group

The ImageList_BeginDrag function begins dragging an image.

BOOL ImageList_BeginDrag(

    HIMAGELIST himlTrack, 

    int iTrack, 

    int dxHotspot,

    int dyHotspot

   );

Parameters

himlTrack 
Handle to the image list.
iTrack
Index of the image to drag.
dxHotspot and dyHotspot
Location of the drag position relative to the upper-left corner of the image.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

This function creates a temporary image list that is used for dragging. In response to subsequent WM_MOUSEMOVE messages, you can move the drag image by using the ImageList_DragMove function. To end the drag operation, you can use the ImageList_EndDrag function.

See Also

ImageList_DragMove, ImageList_EndDrag, WM_MOUSEMOVE