Partager via


ImageList_GetDragImage

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function retrieves the temporary image list that is used for the drag image. ImageList_GetDragImage also retrieves the current drag position and the offset of the drag image relative to the drag position.

Syntax

HIMAGELIST WINAPI ImageList_GetDragImage(
  POINT FAR* ppt, 
  POINT FAR* pptHotspot 
);

Parameters

  • ppt
    [out] Pointer to the pointer to a POINT structure that receives the current drag position. Can be NULL.
  • pptHotspot
    [out] Pointer to the pointer to a POINT structure that receives the offset of the drag image relative to the drag position. Can be NULL.

Return Value

The handle to the image list indicates success. NULL indicates failure.

Remarks

The temporary image list is destroyed when the ImageList_EngDrag function is called. To begin a drag operation, use the ImageListBeginDrag function.

Requirements

Header commctrl.h
Library commctrl.lib, Imgctl.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

POINT