Partager via

macro ImageList_LoadBitmap (commctrl.h)

  • Article

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

Syntaxe

HIMAGELIST ImageList_LoadBitmap(
   HINSTANCE hi,
   LPCTSTR   lpbmp,
   int       cx,
   int       cGrow,
   COLORREF  crMask
);

Paramètres

hi

Type : HINSTANCE

Handle de l’instance qui contient la ressource bitmap. Ce paramètre est NULL si vous chargez une bitmap OEM.

lpbmp

Type : LPCTSTR

Image à charger. Si le paramètre hi n’est pasNULL, 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 est 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éduites par les dimensions de la bitmap spécifiée.

cGrow

Type : int

Nombre d’images par lesquelles la liste d’images peut croître lorsque le système doit faire place à 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 la 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

Type : HIMAGELIST

Retourne le handle dans la liste d’images en cas de réussite, ou NULL dans le cas contraire.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête commctrl.h