IImageList::GetDragImage 方法 (commoncontrols.h)

获取用于拖动图像的临时图像列表。 此函数还将检索当前拖动位置和拖动图像相对于拖动位置的偏移量。

语法

HRESULT GetDragImage(
  [out] POINT  *ppt,
  [out] POINT  *pptHotspot,
  [out] REFIID riid,
  [out] void   **ppv
);

参数

[out] ppt

类型: POINT*

指向接收当前拖动位置的 POINT 结构的指针。 可以为 NULL

[out] pptHotspot

类型: POINT*

指向 POINT 结构的指针,该结构接收拖动图像相对于拖动位置的偏移量。 可以为 NULL

[out] riid

类型: REFIID

映像列表的 IID。

[out] ppv

类型: PVOID*

如果成功,则为指向图像列表接口的指针的地址;否则为 NULL

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

调用 IImageList::EndDrag 时,将销毁临时图像列表。 若要开始拖动操作,请使用 IImageList::BeginDrag

若要使用 IImageList::GetDragImage,请在清单中指定 Comctl32.dll 版本 6。 有关清单的详细信息,请参阅 启用视觉样式

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 commoncontrols.h
DLL Comctl32.dll (6.0 或更高版本)