Share via

ImageList_BeginDrag

  • Article

This function begins dragging an image.

BOOL WINAPI ImageList_BeginDrag(
  HIMAGELIST himlTrack, 
  int iTrack, 
  int dxHotspot, 
  int dyHotspot 
);

Parameters

  • himlTrack
    [in] Handle to the image list.
  • iTrack
    [in] Index of the image to drag.
  • dxHotspot and dyHotspot
    [in] Specifies the location of the drag position relative to the upper-left corner of the image.

Return Values

Nonzero indicates success. Zero indicates failure.

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.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Commctrl.h.
Link Library: Commctrl.lib, Imgctl.lib.

See Also

ImageList_DragMove | ImageList_EndDrag | ImageList_GetDragImage

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.