CImageList 图像列表

一、CImageList类Create函数参数解析

BOOL Create(
   int cx,
   int cy,
   UINT nFlags,
   int nInitial,
   int nGrow 
);

1.1）

cx,cy：图片的实际像素宽与高；

nFlags：创建图像列表的类型,包括4/8/16/24/32/位色；

        nFlags确定建立图像列表的类型，可以是以下值的组合：ILC_COLOR、ILC_COLOR4、ILC_COLOR8、ILC_COLOR16、ILC_COLOR24、ILC_COLOR32、 ILC_COLORDDB和ILC_MASK；
        用的较多的是ILC_COLOR32表示颜色数目，自然越多越好。ILC_MASK也很常用，如果不设置这个值，那个图标透明的地方会被黑色填充。

nInitial：创建ImageList初始包括的图像个数；

nGrow：当初始分配的图像个数不够的时候，新增一个图片时，指定图象列表能增加的新图象个数（难理解）；

nGrow 具体解释：图像列表空间不够而继续添加image时，将按照nGrow继续分配空间，设计时根据具体情况设置合适的值，避免内存频繁的改变图像列表，因为过度频繁会使系统记忆体碎片化。

（当图像列表空间用完不够了，内存中再开辟nGrow个元素空间！）

1.2）举例说明：

nInitial = 2，nGrow=3

按照上方设置，当你添加了两个图像元素以后，还想添加第三个的时候，初始创建分配的nInitial已经使用完了。此时，系统会根据nGrow，为自动增大Imagelist 3个元素容量。此时我们的Imagelist就可以容纳5个图像元素了。如果5个使用完毕后，会继续按照nGrow进行再分配，类似于一个可变数组。

但参数到底设置多少，还是要根据实际的情况设置合理的值，一要避免浪费空间，又要避免频繁的对Image容器进行resize操作。

参考：CImageList类Create函数参数解析-CSDN博客

二、CImageList用法

1.综述
在MFC中CImageList类封装了图像列表控件的功能，图像列表是一个具有相同大小的图像（可以是不同类型）的集合，其主要用于应用程序中大规模图标的存储。该控件是不可见的，通常与其它如CListBox，CComboBox，CComboBoxEx，CTabCtrl以及CTreeCtrl一起使用，为他们提供图标资源。

图象的每个集合中均以0为图象索引基数，可以把这些图标看成是以数组方式存储的，图像列表通常由大图标或位图构成，其中包含位图模式。实际上，所有的在同一个图象列表中的图标都被存储在一个屏幕设备的位图中。

2.添加图像的两种方法
通常可以向CImageList对象中添加位图和图标资源。其资源可以是程序中资源文件中的资源，也可以直接从外部文件调入。

(1)从程序中资源文件中添加图标和位图图像如下所示（通常这是最为简单直观的方法）：

// 创建一个CImageList类的指针变量  
CImageList* pImageList;  
pImageList = new CImageList();  
pImageList->Create(32, 32, ILC_COLOR32, 0, 4); // 必不可少  
  
// 添加图标，图标可以随图像列表大小自动拉伸  
pImageList->Add(AfxGetApp()->LoadIcon(IDI_ICON1));  
pImageList->Add(AfxGetApp()->LoadIcon(IDI_ICON2));  
  
// 添加位图，并使黑色为透明色,如果图像列表大小和位图大小不一致可能会导致天添加失败  
CBitmap bmp;  
bmp.LoadBitmap(IDB_BITMAP1)  
pImageList->Add(&bmp, RGB(0, 0, 0));  
bmp.DeleteObject();  
bmp.LoadBitmap(IDB_BITMAP2)  
pImageList->Add(&bmp, RGB(0, 0, 0));

(2)从外部文件中添加图标和位图图像代码如下所示（这种方法可以是可执行程序更小，便于发行）

HBITMAP hBitmap;  
CBitmap *pBitmap;  
CString FilePathName = "e:/TIME.bmp";  
pBitmap = new   CBitmap;  
//从文件导入位图  
  
HBitmap=(HBITMAP)LoadImage(AfxGetInstanceHandle(),FilePathName,  
  
IMAGE_BITMAP,0,0,LR_LOADFROMFILE);  
pBitmap->Attach(hBitmap);  
m_pImageList->Add(pBitmap, RGB(0,0,0));

这样一个图像列表控件就创建好了，并且已经添加了图像，接下来就可以在其它控件中使用其中的图像。通常需要调用SetImageList(m_pImageList)将当前图像列表设置为引用图像源。

参考文章：CImagelist 基本用法-CSDN博客