图像列表

  • 项目

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

概述

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

函数

主题 目录
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 函数一起使用。