Share via

ImageList_GetDragImage

  • Article

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.

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 Values

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

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Commctrl.h   Commctrl.lib, Imgctl.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

POINT

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.