CImageList

图像列表控制（CImageList）是相同大小图像的一个集合，每个集合中均以0为图像的索引序号基数，图像列表通常由大图标或位图构成，其中包含透明位图模式。可以利用WINDOWS32位应用程序接口函数API来绘制、建立和删除图像，并能实现增加、删除、替换和拖动图像等操作。图像列表控制提供了控制图像列表的基本方法，这些方法在WINDOWS95及以后版本才能实现。

（一）图像控制的对象结构

1、图像控制的数据成员

m_hImageList 连接图像对象的控制句柄

2、图像控制的建立方法

CimageList＆imageList建立图像控制对象结构

Create 初始化图像列表并绑定对象图像控制的建立方法如下：

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

BOOL Create(UINT nBitmapID, int cx, int nGrow, COLORREF crMask );

BOOL Create(LPCTSTR lpszBitmapID, int cx, int nGrow, COLORREF crMask );

BOOL Create( CImageList& imagelist1, int nImage1, CImageList& imagelist2,int nImage2,int dx, int dy );

其中各项参数的含义为：

cx定义图像的宽度，单位为象素；

cy定义图象的高度，单位为象素；

nFlags确定建立图像列表的类型，可以是以下值的组合：ILC_COLOR、ILC_COLOR4、ILC_COLOR8、ILC_COLOR16、 ILC_COLOR24、ILC_COLOR32、ILC_COLORDDB和ILC_MASK；

ILC_COLOR 缺省模式，默认＝ILC_COLOR4。老版本的系统是ILC_COLORDDB使用设备依赖位图。

ILC_COLOR4 4位DIB位图，表示生成的位图每个像素是由4位组成，也就是16色位图。

ILC_COLOR8 同上，8位位图，256色。

——上面2个都要用到调色板。

ILC_COLOR16 16 位DIB(32/64k 色) 位图。

ILC_COLOR24 24 位真彩色位图。

ILC_COLOR32 32位真彩，显示效果跟ILC_COLOR24位一样，多了一个Alpha通道，记录透明度，方便操作。

ILC_COLORDDB 设备依赖位图，表示颜色位跟设备（操作系统记录着）相关。

ILC_MASK 使用掩膜，当前ImageList使用2个位图，如果指定了一个单色位图，就将其做为掩膜，掩膜是用来透明的，就是显示时候不绘制背景——这样看起来效果很真实，xp操作系统桌面的图标就是这个效果。

参数写0，就＝＝ILC_COLOR。默认

nInitial用来确定图像列表包含的图像数量；

nGrow用来确定图像列表可控制的图像数量。

NbitmapID 用来确定图像列表联系的位图标志值；

crMask表示颜色屏蔽位；

LpszBitmapID 用来确定包含位图资源的标识串；

imagelist1 指向图像列表控制对象的一个指针；

nImage1图像列表1中包含的图像数量；

imagelist2指向图像列表控制对象的一个指针；

nImage2图像列表2中包含的图像数量；

dx表示以象素为单位的图像宽度；

dy表示以象素为单位的图像高度。

同样，图像控制的建立也包括两个步骤，首先建立图像列表结构，然后建立图像列表控制。

3、图像控制的属性类

图像控制的属性类包括返回m_hImageList.

控制句柄GetSafeHandle、

取得图像列表中的图像数量GetImageCount、

设置图像列表的背景颜色SetBkColor、

取得图像列表的背景颜色SetBkColor和

取得图像的有关信息SetBkColor。

4、图像控制的操作方法

图像控制的操作方法包括

将一个图像列表绑定到一个对象上Attach、

将对象上的图像列表解除绑定并返回句柄Detach、

删除一个图像列表DeleteImageList、

将一个图像增加到图像列表中Add、

将一个图像从图像列表中删除Remove等。

（二）图像控制的应用技巧

对于图像控制，同样不能单独使用，必须与列表控制、树控制和标签控制相互结合应用，下面分别介绍其具体应用技巧。

1、图像控制在列表控制中的应用技巧

①设置图像控制CListCtrl::SetImageList的调用格式如下：

CImageList* SetImageList( CImageList* pImageList, int nImageList );

其返回值是指向前一个图像列表控制的一个指针，如果不存在前一个图像列表则为NULL；

其中参数：

pImageList是指向图像列表的标识，

nImageList是图像列表的类型，可以是如下值：

LVSIL_NORMAL 用大图标方式进行图像列表；

LVSIL_SMALL 用小图标方式进行图像列表；

LVSIL_STATE 以图像状态进行图像列表；

②取得图像控制CListCtrl::GetImageList的调用格式如下：

CImageList* GetImageList( int nImageList ) const;

其返回值为指向图像列表控制的指针，其中nImageList用来确定取得返回值的图像列表的值，其取值与设置图像列表函数相同。

③图像控制在列表控制中的应用示例

CImageList Cil1,Cil2; //定义大小图标像列表

CVCLISTApp *pApp=(CVCLISTApp *)AfxGetApp();//取得列表控制程序

Cil1.Create(32,32,TRUE,2,2); //建立32位图像控制

Cil1.Add(pApp->LoadIcon(IDI_GJ));//增加选中状态图像

Cil1.Add(pApp->LoadIcon(IDI_XS));//增加非选中状态图像

Cil2.Create(16,16,TRUE,2,2); //建立16位图像控制

Cil2.Add(pApp->LoadIcon(IDI_GJ));//增加选中状态图像

Cil2.Add(pApp->LoadIcon(IDI_XS));//增加非选中状态图像

m_ListCtrl.SetImageList(&Cil1,LVSIL_NORMAL);//设置大图标控制

m_ListCtrl.SetImageList(&Cil2,LVSIL_SMALL);//设置小图标控制

2、图像控制在树控制中的应用技巧

①设置图像控制CTreeCtrl::SetImageList的调用格式如下：

CImageList* SetImageList( CImageList * pImageList, int nImageListType );

其返回值为指向前前一个图像列表的指针，否则为NULL；

参数：

pImageList为指向图像列表的标识，如果pImageList为NULL则所有的图像都将从树控制中被清除；

nImageListType为图像列表设置的类型，可以是如下值之一：TVSIL_NORMAL 设置正常图像列表，其中包括选中和非选中两种图标；TVSIL_STATE 设置图像列表状态，指用户自定义状态；

②取得图像控制CTreeCtrl::GetImageList的调用格式如下：

CImageList* GetImageList( UINT nImage );如果调用成功则返回图像列表控制指针，否则为NULL；nImage为取得返回值的图像列表类型，其取值和取得图像列表控制完全相同。

③图像控制在树控制中的应用示例

CImageList Cil1,Cil2;//定义大小图标像列表

CVCTREEApp *pApp=(CVCTREEApp *)AfxGetApp();//获取应用程序指针

Cil1.Create(16,16,ILC_COLOR,2,2);//建立图像控制

Cil1.Add(pApp->LoadIcon(IDI_PM));//增加选中状态图像

Cil1.Add(pApp->LoadIcon(IDI_CJ));//增加非选中状态图像

m_TreeCtrl.SetImageList(&Cil1,TVSIL_NORMAL);//设置图像控制列表然后

在树控制的结构定义中进行如下设置：

TCItem.item.iImage=0; //设置未选中图像索引号

TCItem.item.iSelectedImage=1;//设置选中时图像引号

3、图像控制在标签控制中的应用技巧

①设置图像控制CTabCtrl::SetImageList的调用格式

CImageList * SetImageList( CImageList * pImageList );其返回值为指向前一个图像列表的指针，如果不存在前一个图像列表则为NULL；

pImageList为标识TAB控制的图像列表指针。

②取得图像控制CTabCtrl::GetImageList的调用格式

HIMAGELIST GetImageList() const;其返回值为指向TAB控制的图像列表指针，如果调用不成功则为NULL。其应用技巧较前两种更加简单，这里不再赘述。