ListView_SetImageList 宏 （commctrl.h）

将图像列表分配给列表视图控件。 可以使用此宏或显式发送 LVM_SETIMAGELIST 消息。

语法

HIMAGELIST ListView_SetImageList(
   HWND       hwnd,
   HIMAGELIST himl,
   int        iImageList
);

参数

hwnd

类型：HWND

列表视图控件的句柄。

himl

类型：HIMAGELIST

要分配的图像列表的句柄。

iImageList

类型：int

图像列表的类型。 此参数可以是以下值之一：

价值	意义
LVSIL_NORMAL	包含大图标的图像列表。
LVSIL_SMALL	带有小图标的图像列表。
LVSIL_STATE	包含状态图像的图像列表。
LVSIL_GROUPHEADER	组标头的图像列表。

返回值

类型：HIMAGELIST

如果成功，则返回以前与控件关联的图像列表的句柄，否则 NULL。

言论

除非设置了 LVS_SHAREIMAGELISTS 样式，否则当列表视图控件被销毁时，将销毁当前图像列表。 如果使用此消息将一个图像列表替换为另一个图像列表，则应用程序必须显式销毁除当前映像列表以外的所有映像列表。

要求

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