VC常用控件用法之图像列表控制Image List

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

2.1 图像控制的对象结构

2.1.1 图像控制的数据成员

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

2.1.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 ； nInitial 用来确定图像列表包含的图像数量； nGrow 用来确定图像列表可控制的图像数量。

NbitmapID  用来确定图像列表联系的位图标志值； crMask 表示颜色屏蔽位；

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

imagelist1  指向图像列表控制对象的一个指针； nImage1 图像列表 1 中包含的图像数 量； imagelist2 指向图像列表控制对象的一个指针； nImage2 图像列表 2 中包含的图像数量； dx 表示以象素为单位的图像宽度； dy 表示以象素为单位的图像高度。

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

2.1.3 图像控制的属性类

图像控制的属性类包括返回 m_hImageList. 控制句柄 GetSafeHandle 、取得图像列表中的图像数量 GetImageCount 、设置图像列表的背景颜色 SetBkColor 、取得图像列表的背景颜色 SetBkColor 和取得图像的有关信息 SetBkColor 。

2.1.4 图像控制的操作方法

图像控制的操作方法包括将一个图像列表绑定到一个对象上 Attach 、将对象上的图像列表解除绑定并返回句柄 Detach 、删除一个图像列表 DeleteImageList 、将一个图像增加到图像列表中 Add 和将一个图像从图像列表中删除 Remove 等。

2.2 图像控制的应用技巧

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

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

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

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

其返回值是指向前一个图像列表控制的一个指针，如果不存在前一个图像列表则为 NULL ；其中参数 pImageList 是指向图像列表的标识， nImageList 是图像列表的类型，可以是如下值：

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

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

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

2.2.1 .2 取得图像控制 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.2.2 图像控制在树控制中的应用技巧

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

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

其返回值为指向前前一个图像列表的指针，否则为 NULL ；参数 pImageList 为指向图像列表的标识，如果 pImageList 为 NULL 则所有的图像都将从树控制中被清除； nImageListType 为图像列表设置的类型，可以是如下值之一：

TVSIL_NORMAL  设置正常图像列表，其中包括选中和非选中两种图标；

TVSIL_STATE   设置图像列表状态，指用户自定义状态；

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

CImageList* GetImageList( UINT nImage );

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

2.2.2 .3 图像控制在树控制中的应用示例

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;// 设置选中时图像引号

2.2.3 图像控制在标 2.2.4 签控制中的应用技巧

2.2.4 .1 设置图像控制 CTabCtrl::SetImageList 的调用格式

CImageList * SetImageList( CImageList * pImageList );

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

2.2.4 .2 取得图像控制 CTabCtrl::GetImageList 的调用格式

HIMAGELIST GetImageList() const;

其返回值为指向 TAB 控制的图像列表指针，如果调用不成功则为 NULL 。