CImageList

CObject

└CImageList

一个“图象列表”是相同大小图象的集合，每个图象都可由其基于零的索引来参考。图象列表用于高效管理大量的图标或位图。图象列表中的所有图象都包含在屏幕设备格式的一个简单的、宽的位图中。一个图象列表还可能包括一个包含用于透明地绘图的掩码的单色位图（图标风格）。Microsoft Win32应用编程接口(API)提供图象列表函数，可以绘图、创建和销毁图象列表、添加和删除图象、替代图象、合并图象和拖动图象。
CImageList 类提供Windows普通图象列表控件的功能。此控件(为此CImageList 类)只对运行在Windows 95和Windows NT 3.51以上的版本的程序有效。
要了解使用CImageList的更多信息，请参阅 “Visual C++程序员指南”中的“控件主题”和“使用CImageList”。
#include <afxcmn.h>

请参阅：CListCtrl, CTabCtrl


CImageList类的成员

数据成员

m_hImageList

包含附加给此对象关联的图象列表的句柄

构造函数

CImageList	构造一个CImageList对象
Create	初始化一个图象列表并把它附加给一个CImageList对象

属性

GetSafeHandle	获取m_hImageList
operator HIMAGELIST	返回附加给CImageList的HIMAGELIST
FromHandle	在给设备一个上下文的句柄时，返回指向CImageList对象的指针。如果无CImageList对象附加给句柄，则临时CImageList对象被创建和附加
FromHandlePermanent	在给图象列表一个句柄时，返回指向CImageList对象的指针。如果无CImageList对象附加给句柄，则返回NULL
DeleteTempMap	被CWinApp闲置处理程序调用，删除一个由FromHandle创建的临时CImageList对象
GetImageCount	获取图象列表中的图象数
SetBkColor	设置图象列表的背景色
GetBkColor	获取图象列表的当前背景色
GetImageInfo	获取图象信息

操作

Attach	将一个图象列表附加给一个CImageList对象
Detach	分离某图象列表对象与某CImageList对象并返回图象列表的句柄
DeleteImageList	删除一个图象列表
SetImageCount	重新设置图象列表中的图象数
Add	添加一个或多个图象到图象列表中
Remove	从图象列表中移走一个图象
Replace	用新图象替代图象列表中的图象
ExtractIcon	构造一个基于某图象的图标的图象列表或掩码
Draw	绘制在某拖拉操作中正被拖动的图象
SetOverlayImage	添加一个图象基于零的索引到将被用于覆盖掩码的图象列表中
Copy	拷贝CimageList对象中的图象
DrawIndirect	绘制图象列表中的图象
SetDragCursorImage	创建一个新的拖动图象
GetDragImage	取得用于拖动的临时图象列表
Read	从归档文件中读取图象列表
Write	往归档文件中写图象列表
BeginDrag	开始拖动图象
DragEnter	在拖动操作中封锁更新并在确定位置显示拖动图象
EndDrag	结束一个拖动操作
DragLeave	解冻窗口并隐藏拖动图象，使窗口能被更新
DragMove	移动正在拖放操作中被拖动的图象
DragShowNolock	在一个拖动操作中显示或隐藏拖动图象，不封锁窗口