fonction ImageList_LoadImageA (commctrl.h)

Crée une liste d’images à partir de la bitmap spécifiée.

Syntaxe

HIMAGELIST ImageList_LoadImageA(
  HINSTANCE hi,
  LPCSTR    lpbmp,
  int       cx,
  int       cGrow,
  COLORREF  crMask,
  UINT      uType,
  UINT      uFlags
);

Paramètres

hi

Type : HINSTANCE

Handle de l’instance qui contient la ressource. Ce paramètre peut être NULL si vous chargez une image à partir d’un fichier ou que vous chargez une ressource OEM.

lpbmp

Type : LPCTSTR

Image à charger.

Si le paramètre uFlags inclut LR_LOADFROMFILE, lpbmp est l’adresse d’une chaîne terminée par null qui nomme le fichier contenant l’image à charger.

Si le paramètre hi n’est pas NULL et que LR_LOADFROMFILE n’est pas spécifié, 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 et que LR_LOADFROMFILE n’est pas spécifié, le LOWORD de ce paramètre doit être l’identificateur d’une image OEM à charger. Pour créer cette valeur, utilisez la macro MAKEINTRESOURCE avec l’un des identificateurs d’image OEM définis dans Winuser.h. Ces identificateurs ont les préfixes suivants.

Valeur	Signification
OBM_ pour les bitmaps OEM
OIC_ pour les icônes OEM
OCR_ pour les curseurs OEM

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 ressource 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 l’image bitmap, le curseur ou l’icône spécifié 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é. Si ce paramètre est la valeur CLR_DEFAULT, la couleur du pixel en haut à gauche de l’image est traitée comme la couleur du masque.

uType

Type : UINT

Indicateur qui spécifie le type d’image à charger. Ce paramètre doit être IMAGE_BITMAP pour indiquer qu’une bitmap est chargée.

RemarqueImageList_LoadImage est utilisée uniquement avec les fichiers bitmap. Aucun autre type d’image n’est pris en charge.

 

Valeur	Signification
IMAGE_BITMAP	Charge une bitmap.

uFlags

Type : UINT

Indicateurs qui spécifient comment charger l’image. Ce paramètre peut être une combinaison des valeurs suivantes.

Valeur	Signification
LR_CREATEDIBSECTION	Provoque le retour d’une bitmap de section DIB plutôt qu’une bitmap compatible lorsque le paramètre uType spécifie IMAGE_BITMAP. LR_CREATEDIBSECTION est utile pour charger une bitmap sans la mapper aux couleurs de l’appareil d’affichage.
LR_DEFAULTCOLOR	Utilise le format de couleur de l’affichage.
LR_DEFAULTSIZE	Utilise la largeur ou la hauteur spécifiées par les valeurs de métrique système pour les curseurs et les icônes si le paramètre cx est défini sur zéro. Si cette valeur n’est pas spécifiée et que cx a la valeur zéro, la fonction définit la taille sur celle spécifiée dans la ressource. Si la ressource contient plusieurs images, la fonction définit la taille sur celle de la première image.
LR_LOADFROMFILE	Charge l’image à partir du fichier spécifié par le paramètre lpbmp.
LR_LOADMAP3DCOLORS	Recherche la table de couleurs de l’image et remplace les nuances de gris suivantes par la couleur tridimensionnelle correspondante : Gris Dk : RVB(128, 128, 128)COLOR_3DSHADOW Gris : RVB(192, 192, 192)COLOR_3DFACE Lt Gray : RVB(223, 223, 223)COLOR_3DLIGHT Pour plus d’informations, consultez la section Remarques.
LR_LOADTRANSPARENT	Récupère la valeur de couleur du premier pixel de l’image et remplace l’entrée correspondante dans la table de couleurs par la couleur de fenêtre par défaut (couleur d’affichage COLOR_WINDOW). Tous les pixels de l’image qui utilisent cette couleur deviennent la couleur de valeur de fenêtre par défaut. Cette valeur s’applique uniquement aux images qui ont une table de couleurs correspondante. Pour plus d’informations, consultez la section Remarques.
LR_MONOCHROME	Charge l’image en noir et blanc.
LR_SHARED	Partage le handle d’image si l’image est chargée plusieurs fois. N’utilisez pas cette valeur pour les images qui ont des tailles non traditionnelles susceptibles de changer après le chargement ou pour les images chargées à partir d’un fichier.

Valeur de retour

Type : HIMAGELIST

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

Remarques

LR_LOADTRANSPARENT ne charge pas l’image de manière transparente. Il crée une liste d’images opaques qui apparaît uniquement transparente, car tous les pixels d’arrière-plan ont été modifiés en COLOR_WINDOW. Si les images sont dessinées sur un arrière-plan qui n’est pas la couleur COLOR_WINDOW, l’image ne dessine pas correctement. En outre, LR_LOADTRANSPARENT et LR_LOADMAP3DCOLORS utiliser les couleurs système qui étaient en vigueur au moment où ImageList_LoadImage a été appelée. Si les couleurs système changent par la suite, l’application doit recharger l’image pour remapquer les couleurs.

Note

L’en-tête commctrl.h définit ImageList_LoadImage en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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
bibliothèque	Comctl32.lib
DLL	Comctl32.dll

Voir aussi

LoadImage