MFC - 影像列表

**影像列表**是相同大小影像的集合，每個影像都可以透過其從零開始的索引來引用。影像列表用於有效地管理大量圖示或點陣圖。影像列表由**CImageList 類**表示。

以下是 CImageList 類中的方法列表。

序號	名稱及描述
1	Add 將影像或影像新增到影像列表。
2	Attach 將影像列表附加到 CImageList 物件。
3	BeginDrag 開始拖動影像。
4	Copy 複製 CImageList 物件中的影像。
5	Create 初始化影像列表並將其附加到 CImageList 物件。
6	DeleteImageList 刪除影像列表。
7	DeleteTempMap 由CWinApp空閒時間處理程式呼叫，以刪除由FromHandle建立的任何臨時 CImageList 物件。
8	Detach 將影像列表物件從 CImageList 物件分離並返回影像列表的控制代碼。
9	DragEnter 在拖動操作期間鎖定更新並在指定位置顯示拖動影像。
10	DragLeave 解鎖視窗並隱藏拖動影像，以便可以更新視窗。
11	DragMove 在拖放操作期間移動正在拖動的影像。
12	DragShowNolock 在拖動操作期間顯示或隱藏拖動影像，而無需鎖定視窗。
13	Draw 繪製在拖放操作期間正在拖動的影像。
14	DrawEx 在指定的裝置上下文繪製圖像列表項。該函式使用指定的繪製樣式並將影像與指定的顏色混合。
15	DrawIndirect 從影像列表繪製圖像。
16	EndDrag 結束拖動操作。
17	ExtractIcon 基於影像列表中的影像和蒙版建立圖示。
18	FromHandle 給定影像列表的控制代碼時，返回指向 CImageList 物件的指標。如果 CImageList 物件未附加到控制代碼，則會建立一個臨時 CImageList 物件並將其附加。
19	FromHandlePermanent 給定影像列表的控制代碼時，返回指向 CImageList 物件的指標。如果 CImageList 物件未附加到控制代碼，則返回 NULL。
20	GetBkColor 檢索影像列表的當前背景色。
21	GetDragImage 獲取用於拖動的臨時影像列表。
22	GetImageCount 檢索影像列表中的影像數量。
23	GetImageInfo 檢索有關影像的資訊。
24	GetSafeHandle 檢索m_hImageList。
25	Read 從存檔讀取影像列表。
26	Remove 從影像列表中刪除影像。
27	Replace 用新影像替換影像列表中的影像。
28	SetBkColor 設定影像列表的背景色。
29	SetDragCursorImage 建立新的拖動影像。
30	SetImageCount 重置影像列表中影像的數量。
32	SetOverlayImage 將影像的從零開始的索引新增到用作覆蓋蒙版的影像列表中。
33	Write 將影像列表寫入存檔。

讓我們建立一個新的 MFC 應用程式**MFCImageListDemo**，並使用以下設定。

**步驟 1** - 將 bmp 檔案作為資源新增到您的應用程式中。

**步驟 2** - 在 CMFCImageListDemoView 類的標頭檔案中，新增以下兩個變數。

CImageList ImageList;
int nImage;

**步驟 3** - 在 CMFCImageListDemoView 的建構函式中新增以下程式碼。

CMFCImageListDemoView::CMFCImageListDemoView() {
   // TODO: add construction code here
   ImageList.Create(800, 800, ILC_COLOR, 4, 1);
   
   CBitmap bmp;
   bmp.LoadBitmap(IDB_BITMAP1);
   ImageList.Add(&bmp, RGB(0, 0, 0));

}

**步驟 4** - 按如下方式呼叫 CImageList::Draw() 方法。

void CMFCImageListDemoView::OnDraw(CDC* pDC) {
   CMFCImageListDemoDoc* pDoc = GetDocument();
   ASSERT_VALID(pDoc);

   nImage = 0;
   ImageList.Draw(pDC , nImage, CPoint(0,0), ILD_NORMAL);
   Invalidate();

   if (!pDoc)
      return;

   // TODO: add draw code for native data here
}

**步驟 5** - 當您執行此應用程式時，您將看到以下輸出。

mfc_windows_controls.htm

列印頁面