iImageList 接口 (commoncontrols.h)

公开操作图像列表并与之交互的方法。

若要使用 IImageList，请在清单中指定 Comctl32.dll 版本 6。 如果不这样做，默认情况下将使用 Comctl32.dll 版本 5， IImageList 可能会显示不可预知的行为。 有关清单的详细信息，请参阅 启用视觉样式。

继承

IImageList 接口继承自 IUnknown 接口。 IImageList 还具有以下类型的成员：

方法

IImageList 接口包含以下方法。

IImageList：：Add 向图像列表添加图像。 (IImageList.Add)
IImageList：：AddMasked 将一个或多个图像添加到图像列表，从指定的位图生成掩码。 (IImageList.AddMasked)
IImageList：：BeginDrag 开始拖动图像。 (IImageList.BeginDrag)
IImageList：：Clone 克隆现有映像列表。
IImageList：：Copy 从给定图像列表中复制图像。
IImageList：:D ragEnter 在拖动操作期间锁定指定窗口的更新，并在窗口中的指定位置显示拖动图像。 (IImageList.DragEnter)
IImageList：:D ragLeave 解除锁定指定的窗口并隐藏拖动图像，使窗口能够更新。
IImageList：:D ragMove 移动在拖放操作期间拖动的图像。 通常调用此函数以响应WM_MOUSEMOVE消息。 (IImageList.DragMove)
IImageList：:D ragShowNolock 显示或隐藏正在拖动的图像。 (IImageList.DragShowNolock)
IImageList：:D raw 在指定的设备上下文中绘制图像列表项。 (IImageList.Draw)
IImageList：：EndDrag 结束拖动操作。 (IImageList.EndDrag)
IImageList：：GetBkColor 获取图像列表的当前背景色。
IImageList：：GetDragImage 获取用于拖动图像的临时图像列表。 此函数还将检索当前拖动位置和拖动图像相对于拖动位置的偏移量。
IImageList：：GetIcon 从图像创建图标，在图像列表中创建掩码。
IImageList：：GetIconSize 获取图像列表中图像的尺寸。 图像列表中的所有图像具有相同的尺寸。
IImageList：：GetImageCount 获取图像列表中的图像数。
IImageList：：GetImageInfo 获取有关图像的信息。
IImageList：：GetImageRect 获取图像的边框。
IImageList：：GetItemFlags 获取图像的标志。
IImageList：：GetOverlayImage 从用作覆盖掩码的图像列表中检索指定的图像。
IImageList：：Merge 通过组合两个现有映像创建新映像。 此方法还会创建一个新的图像列表，用于存储图像。
IImageList：：Remove 从图像列表中移除图像。 (IImageList.Remove)
IImageList：：Replace 将图像列表中的图像替换为新图像。 (IImageList.Replace)
IImageList：：ReplaceIcon 用图标或光标替换图像。 (IImageList.ReplaceIcon)
IImageList：：SetBkColor 设置图像列表的背景色。
IImageList：：SetDragCursorImage 通过将指定的图像（通常是鼠标光标图像）与当前拖动图像相结合，创建新的拖动图像。
IImageList：：SetIconSize 设置图像列表中图像的尺寸，并从列表中删除所有图像。 (IImageList.SetIconSize)
IImageList：：SetImageCount 调整现有图像列表的大小。 (IImageList.SetImageCount)
IImageList：：SetOverlayImage 将指定的图像添加到用作覆盖掩码的图像列表中。

要求

最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	commoncontrols.h

另请参阅

图像列表