CImageList

m_hImageList 連接圖像對象的控制句柄

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 位圖資源ID；crMask表示顏色屏蔽位；

LpszBitmapID 位圖資源的路徑；

imagelist1 指向圖像列表控制對象的一個指針；nImage1圖像列表1中包含的圖像數量；imagelist2指向圖像列表控制對象的一個指針；nImage2圖像列表2中包含的圖像數量；dx表示以象素為單位的圖像寬度；dy表示以象素為單位的圖像高度。

同樣，圖像控制的建立也包括兩個步驟，首先建立圖像列表結構，然後建立圖像列表控制。

圖像控制的屬性類包括返回m_hImageList.控制句柄GetSafeHandle、取得圖像列表中的圖像數量GetImageCount、設置圖像列表的背景顏色SetBkColor、取得圖像列表的背景顏色GetBkColor和取得圖像的有關信息SetBkColor。

圖像控制的操作方法包括將一個圖像列表綁定到一個對象上Attach、將對象上的圖像列表解除綁定並返回句柄Detach、刪除一個圖像列表DeleteImageList、將一個圖像增加到圖像列表中Add和將一個圖像從圖像列表中刪除Remove等。

由於圖像列表不是窗口，它們本身並不是控件；但它們和幾種不同類型的控件一起使用，包括列表控件（CListCtrl）、樹控件（CTreeCtrl）和選項卡控件（CTabCtrl）。圖像列表中的所有圖像包含在屏幕設備格式的單個寬位圖中。圖像列表也可能包括單色位圖，該位圖包含用於透明地繪製圖像（圖標樣式）的屏蔽。CImageList提供的成員函數使您得以繪製圖像，創建和銷燬圖像列表，添加和移除圖像，替換圖像，合併圖像，以及拖動圖像。

圖像列表類型

有兩種類型的圖像列表（CImageList）：非屏蔽的和屏蔽的。非屏蔽的圖像列表由包含一個或多個圖像的色位圖構成。屏蔽的圖像列表由相同大小的兩個位圖構成。第一個是包含圖像的色位圖，第二個是包含一系列屏蔽的單色位圖（一個屏蔽對應第一個位圖中的一個圖像）。

Create成員函數的一個重載創建一個標誌指示圖像列表是否是屏蔽的。（其他重載創建屏蔽的圖像列表）。

繪製非屏蔽圖像時，只是簡單地將其複製到目標DC。繪製屏蔽圖像時，圖像位和屏蔽位組合，一般在位圖中產生顯露目標DC背景色的透明區域。繪製屏蔽圖像時可以指定幾種繪圖樣式。例如，可以指定圖像進行抖色處理以指示選定的對象。

使用圖像列表

構造CImageList對象，調用其Create函數的一個重載來創建圖像列表並將圖像列表附加到CImageList對象；

如果在創建圖像列表時沒有添加圖像，則調用Add或Read成員函數向圖像列表添加圖像；

通過調用控件的適當成員函數，將圖像列表與此控件相關聯，或者您自己使用圖像列表的Draw成員函數繪製圖像列表中的圖像；

或許允許用户是以圖像列表的內置拖動支持拖動圖像。

注意：如果圖像列表是用new運算符創建的，則在操作完CImageList對象後必須銷燬它。

操作圖像列表

Replace成員函數用新的圖像替換圖像列表（CImageList）中的圖像。如果需要動態增加圖像列表中的圖像數，該函數也有用。SetImageCount函數動態更改存儲在圖像列表中的圖像數。如果增加圖像列表的大小，請調用Replace向新圖像增加圖像。如果減少圖像列表的大小，則釋放超過新大小的圖像。

Remove成員函數移除圖像列表中的圖像。Copy成員函數可以在圖像列表內複製或交換圖像。該函數使您得以指示是否應將源圖像複製到目標索引，還是應交換源圖像和目標圖像。

若要通過合併兩個圖像列表來創建新的圖像列表，請使用Create成員函數的適當重載。該Create重載合併現有的圖像列表的第一個圖像，並將所得的圖像存儲在新的圖像列表對象中。通過在第一個圖像上透明地繪製第二個圖像來創建新圖像。新圖像的屏蔽是對兩個現有圖像的屏蔽位執行邏輯OR元算的結果。

該操作一直重複到所有圖像都合併並添加到新的圖像列表中。

可以調用Write成員函數將圖像信息寫入存檔，並通過調用Read成員函數讀回。

GetSafeHandle、Attach和Detach成員函數使您得以操作附加到CImageList對象的圖像列表句柄，而DeleteImageList成員函數刪除圖像列表但不銷燬CImageList對象。

繪製圖像列表中的圖像

若要繪製圖像，請使用CImageList::Draw成員函數。您將需要指定指向DC的指針，要繪製的圖像的索引，DC中繪製圖像的位置，以及一組指示繪圖樣式的標誌。

指定ILD_TRANSPARENT樣式後，Draw是以一個兩步進程來繪製屏蔽的圖像。

對於圖像控制，同樣不能單獨使用，必須與列表控制、樹控制和標籤控制相互結合應用，下面分別介紹其具體應用技巧。

圖像控制在列表控制中的應用技巧

1.1 設置圖像控制CListCtrl::SetImageList的調用格式如下：

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

其返回值是指向前一個圖像列表控制的一個指針，如果不存在前一個圖像列表則為NULL；其中參數pImageList是指向圖像列表的標識，nImageList是圖像列表的類型，可以是如下值：

LVSIL_NORMAL 用大圖標方式進行圖像列表；

LVSIL_SMALL 用小圖標方式進行圖像列表；

LVSIL_STATE 以圖像狀態進行圖像列表；

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.1 設置圖像控制CTreeCtrl::SetImageList的調用格式如下：

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

其返回值為指向前前一個圖像列表的指針，否則為NULL；參數pImageList為指向圖像列表的標識，如果pImageList為NULL則所有的圖像都將從樹控制中被清除；nImageListType為圖像列表設置的類型，可以是如下值之一：

TVSIL_NORMAL 設置正常圖像列表，其中包括選中和非選中兩種圖標；

TVSIL_STATE 設置圖像列表狀態，指用户自定義狀態；

2.2 取得圖像控制CTreeCtrl::GetImageList的調用格式如下：

CImageList* GetImageList( UINT nImage );

如果調用成功則返回圖像列表控制指針，否則為NULL；nImage為取得返回值的圖像列表類型，其取值和取得圖像列表控制完全相同。

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;//設置選中時圖像引號

3 圖像控制在控制中的應用技巧

1.設置圖像控制CTabCtrl::SetImageList的調用格式

CImageList * SetImageList( CImageList * pImageList );

其返回值為指向前一個圖像列表的指針，如果不存在前一個圖像列表則為NULL；pImageList為標識TAB控制的圖像列表指針。

2 取得圖像控制CTabCtrl::GetImageList的調用格式

HIMAGELIST GetImageList() const;

其返回值為指向TAB控制的圖像列表指針，如果調用不成功則為NULL。

CImageList類的成員

屬性

操作