CImageList用法介绍

朱雀 2023-10-18 08:27 34阅读 0赞

图像列表控制（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（图像为24色）、ILC\_COLOR8（图像为28色）、ILC\_COLOR16（图像为216色）、ILC\_COLOR24、ILC\_COLOR32、ILC\_COLORDDB和ILC\_MASK；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用来确定取得返回值的图像列表的值，其取值与设置图像列表函数相同。

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

注意：加入位图时要设置图标显示状态为LVSIL\_NORMAL，加入icon图标时，如果图标大小为32×32，则也设置图标显示状态为LVSIL\_NORMAL，否则设置为LVSIL\_SMALL。

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);//设置小图标控制

另外一种加载BMP位图的方法是：

CimageList\* m\_pImageList = new CimageList();

HBITMAP hBitmap;

CBitmap\* pBitmap;

strBmpPath = "\\\\\*.bmp";

hBitmap = (HBITMAP)LoadImage(NULL,(LPCTSTR)strBmpPathDisCnnct,IMAGE\_BITMAP,0,0,LR\_LOADFROMFILE);

pBitmap = new CBitmap;

pBitmap->Attach(hBitmap);

m\_pImageList->Add(pBitmap,RGB(0,0,0));

delete pBitmap

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。  
  
在MFC中CImageList类封装了图像列表控件的功能，图像列表是一个具有相同大小的图像（可以是不同类型）的集合，其主要用于应用程序中大

规模图标的存储，该控件是不可见的。通常与其它如CListBox，CComboBox，CComboBoxEx以及CTabCtrl一起使用，为他们提供图标资源。

图象的每个集合中均以0为图象索引基数，可以把这些图标看成是以数组方式存储的，图像列表通常由大图标或位图构成，其中包含位图模式，

实际上，所有的在同一个图象列表中的图标都被存储在一个屏  
幕设备的位图中。

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

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

![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]// 创建一个CImageList类的指针变量  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]CImageList\* pImageList;  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]pImageList = new CImageList();  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]pImageList->Create(32, 32, ILC\_COLOR32, 0, 4);  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]// 添加图标，图标可以随图像列表大小自动拉伸  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]pImageList->Add(AfxGetApp()->LoadIcon(IDI\_ICON1));  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]pImageList->Add(AfxGetApp()->LoadIcon(IDI\_ICON2));  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]// 添加位图，并使黑色为透明色,如果图像列表大小和位图大小不一致可能会导致天添加失败  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]CBitmap bmp;  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]bmp.LoadBitmap(IDB\_BITMAP1)  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]pImageList->Add(&bmp, RGB(0, 0, 0));  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]bmp.DeleteObject();  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]bmp.LoadBitmap(IDB\_BITMAP2)  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]pImageList->Add(&bmp, RGB(0, 0, 0));

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

![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]HBITMAP hBitmap;  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]CBitmap \*pBitmap;  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]CString FilePathName = "e:\\TIME.bmp";  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]pBitmap = new CBitmap;  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]// 从文件导入位图  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]hBitmap = (HBITMAP)LoadImage(AfxGetInstanceHandle(),FilePathName,IMAGE\_BITMAP,0,0,LR\_LOADFROMFILE);  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]pBitmap->Attach(hBitmap);  
![CImageList用法介绍 - 清雨小竹 - 清雨小竹][CImageList_ - _ -]m\_pImageList->Add(pBitmap, RGB(0,0,0));

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

[CImageList_ - _ -]: http://images.csdn.net/syntaxhighlighting/OutliningIndicators/None.gif