CImageList::Add

發行項
02/28/2013

呼叫此函式將一個或多個影像或圖示加入至影像清單。

int Add(
   CBitmap* pbmImage,
   CBitmap* pbmMask 
);
int Add(
   CBitmap* pbmImage,
   COLORREF crMask 
);
int Add(
   HICON hIcon 
);

參數

pbmImage
含有影像或影像的點陣圖的指標。影像的數目從點陣圖的寬度論斷。
pbmMask
out 包含遮罩的點陣圖的指標。如果遮罩不適用於影像清單，則會忽略這個參數。
crMask
用來產生遮罩的色彩。這個色彩每像素給定之點陣圖的變更為黑色，而遮罩中的對應位元設為一個。
hIcon
包含點陣圖和遮罩新影像的圖示的控制代碼。

傳回值

第一個新的影像之以零起始的索引，如果成功，則為– 1。

備註

當您完成使用後，您必須負責釋放圖示控制代碼。

範例

// Add my icons.
m_myImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON1));
m_myImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON2));

// Add my bitmap, make all black pixels transparent.
CBitmap bm;
bm.LoadBitmap(IDB_BITMAP1);
m_myImageList.Add(&bm, RGB(0, 0, 0));