TreeView_CreateDragImage 宏 (commctrl.h)

为树视图控件中的指定项创建拖动位图。 宏还会为位图创建图像列表,并将位图添加到图像列表中。 应用程序可以使用图像列表函数拖动项时显示图像。 可以使用此宏或显式发送 TVM_CREATEDRAGIMAGE 消息。

语法

HIMAGELIST TreeView_CreateDragImage(
   HWND      hwnd,
   HTREEITEM hitem
);

参数

hwnd

类型:HWND

树视图控件的句柄。

hitem

类型:HTREEITEM

接收新拖动位图的项的句柄。

返回值

类型:HIMAGELIST

返回拖动位图成功时添加到的图像列表的句柄,否则 NULL

言论

如果在没有关联的图像列表的情况下创建树视图控件,则无法使用 TreeView_CreateDragImage 宏创建在拖动操作期间显示的图像。 必须实现自己的创建拖动光标的方法。

应用程序负责在不再需要映像列表时销毁映像列表。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 commctrl.h