macro ImageList_LoadBitmap (commctrl.h)

Appelle la fonction ImageList_LoadImage pour créer une liste d’images à partir de la ressource bitmap spécifiée.

Syntaxe

void ImageList_LoadBitmap(
   hi,
   lpbmp,
   cx,
   cGrow,
   crMask
);

Paramètres

hi

Type : HINSTANCE

Handle du instance qui contient la ressource bitmap. Ce paramètre a la valeur NULL si vous chargez une bitmap OEM.

lpbmp

Type : LPCTSTR

Image à charger. Si le paramètre hi n’est pas NULL, lpbmp est l’adresse d’une chaîne terminée par null qui contient le nom de la ressource d’image dans le module hi . Si hi a la valeur NULL, le LOWORD de ce paramètre doit être l’identificateur d’une bitmap OEM à charger. Pour créer cette valeur, utilisez la macro MAKEINTRESOURCE avec l’un des identificateurs bitmap OEM définis dans WINUSER.H. Ces identificateurs ont le préfixe OBM_.

cx

Type : int

Largeur de chaque image. La hauteur de chaque image et le nombre initial d’images sont déduits par les dimensions de la bitmap spécifiée.

cGrow

Type : int

Nombre d’images par lesquels la liste d’images peut augmenter lorsque le système a besoin de faire de la place pour de nouvelles images. Ce paramètre représente le nombre de nouvelles images que la liste d’images redimensionnées peut contenir.

crMask

Type : COLORREF

Couleur utilisée pour générer un masque. Chaque pixel de cette couleur dans l’image bitmap spécifiée est remplacé par noir, et le bit correspondant dans le masque est défini sur 1. Si ce paramètre est la valeur CLR_NONE, aucun masque n’est généré.

Valeur de retour

None

Configuration requise

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	commctrl.h