fonction ImageList_LoadImageA (commctrl.h)

Crée une liste d’images à partir de l’image 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 du instance qui contient la ressource. Ce paramètre peut avoir la valeur NULL si vous chargez une image à partir d’un fichier ou si 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 a la valeur 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éduits par les dimensions de la ressource 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, le curseur ou l’icône spécifiés 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 dans le coin supérieur 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 en cours de chargement.

NotezImageList_LoadImage est à utiliser uniquement avec des 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 la fonction à retourner 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 l’image dans la table de couleurs et remplace les nuances de gris suivantes par la couleur tridimensionnelle correspondante : Dk Gray : 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 Notes.
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 (la 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 Notes.
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 qui peuvent changer après le chargement ou pour les images chargées à partir d’un fichier.

Valeur retournée

Type : HIMAGELIST

Retourne le handle à 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 opaque qui n’apparaît que 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é. Si les couleurs système changent par la suite, l’application doit recharger l’image pour remappager les couleurs.

Notes

L’en-tête commctrl.h définit ImageList_LoadImage comme un 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.

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

Voir aussi

LoadImage