图像列表控制(
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
。