CImageList::Add

Artikel
02/26/2013

Rufen Sie diese Funktion auf, um eine oder mehrere Bilder oder ein Symbol einer Bildliste hinzuzufügen.

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

Parameter

pbmImage
Zeiger auf die Bitmap, die das Bild oder die Bilder enthält.Die Anzahl von Bildern wird von der Breite der Bitmap abgeleitet.
pbmMask
Zeiger auf die Bitmap, die die Maske enthält.Wenn keine Maske mit der Bildliste verwendet wird, wird dieser Parameter ignoriert.
crMask
Farbe verwendet, um die Maske zu generieren.Jedes Pixel dieser Farbe in der angegebenen Bitmap wird geändert, um zu überwachen und das entsprechende Bit in der Maske wird von eine festgelegt.
hIcon
Handle des Symbols, das die Bitmap und die Maske für das neue Bild enthält.

Rückgabewert

Der nullbasierte Index des ersten neuen Bilder, wenn erfolgreich; andernfalls. - 1.

Hinweise

Sie sind für das Freigeben des Symbolhandles zuständig, wenn Sie damit fertig sind.

Beispiel

// 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));