Partager via


CImageList::Add

Appelez cette fonction pour ajouter un ou plusieurs images ou une icône à une liste d'images.

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

Paramètres

  • pbmImage
    Pointeur vers la bitmap contenant l'image ou les images. Le nombre d'images est déduit de la largeur de la bitmap.

  • pbmMask
    Pointeur vers la bitmap contenant le masque. Si aucun caractère générique n'est utilisé avec la liste d'images, ce paramètre est ignoré.

  • crMask
    Couleur utilisée pour générer le masque. Chaque pixel de cette couleur dans la bitmap donnée est modifié pour noircir et le bit correspondant dans le masque est placé à un.

  • hIcon
    Handle de l'icône qui contient la bitmap et le masque de la nouvelle image.

Valeur de retour

Index de base zéro de la première image si l'opération a réussi ; sinon – 1.

Notes

Vous êtes chargé de libérer le handle de l'icône lorsque vous avez terminé avec elle.

Exemple

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

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

CImageList, classe

Graphique de la hiérarchie

CImageList::Remove

CImageList::Replace

COLORREF