图像列表

本接包含有关与图像列表一起使用的编程元素的信息。

概述

主题	目录
图像列表	图像列表是大小相同的图像集合，其中的每个图像都可以通过其索引进行引用。

函数

主题	目录
HIMAGELIST_QueryInterface	检索指向 IImageList 或 IImageList2 对象的指针，该对象与图像列表的 HIMAGELIST 句柄相对应。
ImageList_Add	向图像列表添加图像。
ImageList_AddMasked	在图像列表中添加一个或多个图像，从指定位图生成掩模。
ImageList_BeginDrag	开始拖动图像。
ImageList_CoCreateInstance	创建图像列表的单个实例，并返回指向其的接口指针。
ImageList_Copy	复制给定图像列表中的图像。
ImageList_Create	创建新的图像列表。
ImageList_Destroy	销毁图像列表。
ImageList_DragEnter	在窗口内的指定位置显示拖动图像。
ImageList_DragLeave	解锁指定窗口并隐藏拖动图像，从而允许更新窗口。
ImageList_DragMove	移动在拖放操作期间拖动的图像。 调用该函数通常是为了响应 WM_MOUSEMOVE 消息。
ImageList_DragShowNolock	显示或隐藏正在拖动的图像。
ImageList_Draw	在指定的设备上下文中绘制图像列表项。
ImageList_DrawEx	在指定的设备上下文中绘制图像列表项。 该函数使用指定的绘图样式，并将图像与指定颜色混合。
ImageList_DrawIndirect	根据 IMAGELISTDRAWPARAMS 结构绘制图像列表图像。
ImageList_Duplicate	创建现有图像列表的副本。
ImageList_EndDrag	结束拖动操作。
ImageList_GetBkColor	检索图像列表的当前背景色。
ImageList_GetDragImage	检索用于拖动图像的临时图像列表。 此函数还将检索当前拖动位置和拖动图像相对于拖动位置的偏移量。
ImageList_GetIcon	根据图像列表中的图像和掩模来创建图标。
ImageList_GetIconSize	检索图像列表中图像的尺寸。 图像列表中的所有图像尺寸都相同。
ImageList_GetImageCount	检索图像列表中的图像数。
ImageList_GetImageInfo	检索有关图像的信息。
ImageList_LoadImage	从指定的位图创建图像列表。
ImageList_Merge	通过合并两个现有图像来创建一个新图像。 该函数还会创建一个新的图像列表来存储图像。
ImageList_Read	从流中读取图像列表。
ImageList_ReadEx	从流中读取图像列表，并返回图像列表的接口。
ImageList_Remove	从图像列表中移除图像。
ImageList_Replace	将图像列表中的图像替换为新图像。
ImageList_ReplaceIcon	将图像替换为图标或光标。
ImageList_SetBkColor	设置图像列表的背景色。 只有在添加图标或将 ImageList_AddMasked 与黑白位图一起使用时，此函数才会起作用。 如果没有掩模，就会绘制整个图像；因此看不到背景颜色。
ImageList_SetColorTable	设置图像列表的颜色表。
ImageList_SetDragCursorImage	将指定图像（通常是鼠标指针图像）与当前拖动图像相结合，以便创建新的拖动图像。
ImageList_SetIconSize	设置图像列表中图像的尺寸，并删除列表中的所有图像。
ImageList_SetImageCount	调整现有图像列表的大小。
ImageList_SetOverlayImage	将指定的图像添加到要用作覆盖掩模的图像列表中。 在 4.70 及更早版本中，一个图像列表最多可以有 4 个覆盖掩模，而在 4.71 版本中最多可以有 15 个。 该函数会为指定图像分配一个覆盖掩模索引。
ImageList_Write	将图像列表写入流。
ImageList_WriteEx	将图像列表写入流。

宏

主题	目录
ImageList_AddIcon	在图像列表中添加图标或光标。 ImageList_AddIcon 会调用 ImageList_ReplaceIcon 函数。
ImageList_ExtractIcon	调用 ImageList_GetIcon 函数，根据图像列表中的图像和掩模来创建图标或光标。
ImageList_LoadBitmap	调用 ImageList_LoadImage 函数，从指定的位图资源创建图像列表。
ImageList_RemoveAll	调用 ImageList_Remove 函数，删除图像列表中的所有图像。
INDEXTOOVERLAYMASK	准备覆盖掩模的索引，以便 ImageList_Draw 函数可以使用它。

接口

主题	目录
IImageList	公开操作图像列表并与之交互的方法。 要使用 IImageList，请在清单中指定 Comctl32.dll 版本 6。 否则，默认情况下将使用 Comctl32.dll 第 5 版，这样 IImageList 可能会显示不可预知的行为。 有关清单的详细信息，请参阅启用视觉样式。

方法

主题	目录
添加	向图像列表添加图像。
AddMasked	在图像列表中添加一个或多个图像，从指定位图生成掩模。
BeginDrag	开始拖动图像。
克隆	克隆现有图像列表。
复制	从给定的图像列表中复制图像。
DragEnter	在拖动操作期间锁定指定窗口的更新，并在窗口内的指定位置显示拖动图像。
DragLeave	解锁指定窗口并隐藏拖动图像，从而让窗口可以更新。
DragMove	移动在拖放操作期间拖动的图像。 调用该函数通常是为了响应 WM_MOUSEMOVE 消息。
DragShowNolock	显示或隐藏正在拖动的图像。
平局	在指定的设备上下文中绘制图像列表项。
EndDrag	结束拖动操作。
GetBkColor	获取图像列表的当前背景色。
GetDragImage	获取用于拖动图像的临时图像列表。 此函数还将检索当前拖动位置和拖动图像相对于拖动位置的偏移量。
GetIcon	根据图像列表中的图像和掩模来创建图标。
GetIconSize	获取图像列表中图像的尺寸。 图像列表中的所有图像尺寸都相同。
GetImageCount	获取图像列表中的图像数。
GetImageInfo	获取有关图像的信息。
GetImageRect	获取图像的边界矩形。
GetItemFlags	获取图像的标志。
GetOverlayImage	从要用作覆盖掩模的图像列表中检索指定图像。
合并	通过合并两个现有图像来创建一个新图像。 此方法也会创建一个新的图像列表来存储图像。
删除	从图像列表中移除图像。
替换	将图像列表中的图像替换为新图像。
ReplaceIcon	将图像替换为图标或光标。
SetBkColor	设置图像列表的背景色。 只有在向图像列表添加图标或使用 IImageList::AddMasked 方法添加黑白位图时，此方法才会起作用。 如果没有掩模，则会绘制整个图像，而背景颜色也不可见。
SetDragCursorImage	将指定图像（通常是鼠标指针图像）与当前拖动图像相结合，以便创建新的拖动图像。
SetIconSize	设置图像列表中图像的尺寸，并删除列表中的所有图像。
SetImageCount	调整现有图像列表的大小。
SetOverlayImage	将指定的图像添加到要用作覆盖掩模的图像列表中。 在通用控件版本 4.70 及更早版本中，一个图像列表最多可以有 4 个覆盖掩模，而在 4.71 或更高版本中最多可以有 15 个。 该方法会为指定图像分配一个覆盖掩模索引。

结构

主题	目录
IMAGEINFO	包含图像列表中图像的相关信息。 此结构与 IImageList::GetImageInfo 函数一起使用。
IMAGELISTDRAWPARAMS	包含图像列表绘制操作的信息并与 IImageList::Draw 函数一起使用。