Listes d’images

Cette section contient des informations sur les éléments de programmation utilisés avec les listes d’images.

Vues d'ensemble

Rubrique	Contenu
Listes d’images	Une liste d’images est une collection d’images de la même taille, chacune d’elles pouvant être référencée par son index.

Fonctions

Rubrique	Contenu
HIMAGELIST_QueryInterface	Récupère un pointeur vers un objet IImageList ou IImageList2 qui correspond au handle HIMAGELIST de la liste d’images.
ImageList_Add	Ajoute une ou plusieurs images à une liste d’images.
ImageList_AddMasked	Ajoute une ou plusieurs images à une liste d’images, générant un masque à partir de l’image bitmap spécifiée.
ImageList_BeginDrag	Commence à faire glisser une image.
ImageList_CoCreateInstance	Crée une instance unique d’une liste d’images et retourne un pointeur d’interface vers celle-ci.
ImageList_Copy	Copie des images dans une liste d’images donnée.
ImageList_Create	Crée une liste d’images.
ImageList_Destroy	Détruit une liste d’images.
ImageList_DragEnter	Affiche l’image glisser à la position spécifiée dans la fenêtre.
ImageList_DragLeave	Déverrouille la fenêtre spécifiée et masque l’image glisser, ce qui permet la mise à jour de la fenêtre.
ImageList_DragMove	Déplace l’image qui est déplacée pendant une opération de glisser-déplacer. Cette fonction est généralement appelée en réponse à un message WM_MOUSEMOVE .
ImageList_DragShowNolock	Affiche ou masque l’image en cours de déplacement.
ImageList_Draw	Dessine un élément de liste d’image dans le contexte d’appareil spécifié.
ImageList_DrawEx	Dessine un élément de liste d’image dans le contexte d’appareil spécifié. La fonction utilise le style de dessin spécifié et fusionne l’image avec la couleur spécifiée.
ImageList_DrawIndirect	Dessine une image de liste d’images basée sur une structure IMAGELISTDRAWPARAMS .
ImageList_Duplicate	Crée un doublon d’une liste d’images existante.
ImageList_EndDrag	Met fin à une opération de glissement.
ImageList_GetBkColor	Récupère la couleur d’arrière-plan actuelle d’une liste d’images.
ImageList_GetDragImage	Récupère la liste d’images temporaires utilisée pour l’image glisser. La fonction récupère également l'emplacement actuel de glissement et le décalage de l'image glissée par rapport à la position de glissement.
ImageList_GetIcon	Crée une icône à partir d’une image et un masque dans une liste d’images.
ImageList_GetIconSize	Récupère les dimensions des images d’une liste d’images. Toutes les images d’une liste d’images ont les mêmes dimensions.
ImageList_GetImageCount	Récupère le nombre d’images dans une liste d’images.
ImageList_GetImageInfo	Récupère des informations sur une image.
ImageList_LoadImage	Crée une liste d’images à partir de l’image bitmap spécifiée.
ImageList_Merge	Crée une image en combinant deux images existantes. La fonction crée également une liste d’images dans laquelle stocker l’image.
ImageList_Read	Lit une liste d’images à partir d’un flux.
ImageList_ReadEx	Lit une liste d’images à partir d’un flux et retourne une interface à la liste d’images.
ImageList_Remove	Supprime une image d’une liste d’images.
ImageList_Replace	Remplace une image dans une liste d’images par une nouvelle image.
ImageList_ReplaceIcon	Remplace une image par une icône ou un curseur.
ImageList_SetBkColor	Définit la couleur d’arrière-plan d’une liste d’images. Cette fonction fonctionne uniquement si vous ajoutez une icône ou utilisez ImageList_AddMasked avec un bitmap en noir et blanc. Sans masque, l’image entière est dessinée ; par conséquent, la couleur d’arrière-plan n’est pas visible.
ImageList_SetColorTable	Définit la table de couleurs pour une liste d’images.
ImageList_SetDragCursorImage	Crée une image glisser en combinant l’image spécifiée (généralement une image de curseur de souris) avec l’image de glisser actuelle.
ImageList_SetIconSize	Définit les dimensions des images dans une liste d’images et supprime toutes les images de la liste.
ImageList_SetImageCount	Redimensionne une liste d’images existante.
ImageList_SetOverlayImage	Ajoute une image spécifiée à la liste d’images à utiliser comme masques de superposition. Une liste d’images peut avoir jusqu’à quatre masques de superposition dans les versions 4.70 et antérieures et jusqu’à 15 dans la version 4.71. La fonction affecte un index de masque de superposition à l’image spécifiée.
ImageList_Write	Écrit une liste d’images dans un flux.
ImageList_WriteEx	Écrit une liste d’images dans un flux.

Macros

Rubrique	Contenu
ImageList_AddIcon	Ajoute une icône ou un curseur à une liste d’images. ImageList_AddIcon appelle la fonction ImageList_ReplaceIcon .
ImageList_ExtractIcon	Appelle la fonction ImageList_GetIcon pour créer une icône ou un curseur basé sur une image et un masque dans une liste d’images.
ImageList_LoadBitmap	Appelle la fonction ImageList_LoadImage pour créer une liste d’images à partir de la ressource bitmap spécifiée.
ImageList_RemoveAll	Appelle la fonction ImageList_Remove pour supprimer toutes les images d’une liste d’images.
INDEXTOOVERLAYMASK	Prépare l’index d’un masque de superposition afin que la fonction ImageList_Draw puisse l’utiliser.

Interfaces

Rubrique	Contenu
IImageList	Expose les méthodes qui manipulent et interagissent avec les listes d’images. Pour utiliser IImageList, spécifiez Comctl32.dll version 6 dans le manifeste. Si vous ne le faites pas, Comctl32.dll version 5 sera utilisée par défaut, avec laquelle IImageList peut afficher un comportement imprévisible. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.

Méthodes

Rubrique	Contenu
Ajouter	Ajoute une ou plusieurs images à une liste d’images.
AddMasked	Ajoute une ou plusieurs images à une liste d’images, générant un masque à partir de l’image bitmap spécifiée.
BeginDrag	Commence à faire glisser une image.
Clone	Clone une liste d’images existante.
Copier	Copie les images d’une liste d’images donnée.
DragEnter	Verrouille les mises à jour de la fenêtre spécifiée lors d’une opération de glissement et affiche l’image de glisser à la position spécifiée dans la fenêtre.
DragLeave	Déverrouille la fenêtre spécifiée et masque l’image glisser, ce qui permet à la fenêtre de se mettre à jour.
DragMove	Déplace l’image qui est déplacée pendant une opération de glisser-déplacer. Cette fonction est généralement appelée en réponse à un message WM_MOUSEMOVE .
DragShowNolock	Affiche ou masque l’image en cours de déplacement.
Dessin	Dessine un élément de liste d’image dans le contexte d’appareil spécifié.
EndDrag	Met fin à une opération de glissement.
GetBkColor	Obtient la couleur d’arrière-plan actuelle d’une liste d’images.
GetDragImage	Obtient la liste d’images temporaires utilisée pour l’image glisser. La fonction récupère également l'emplacement actuel de glissement et le décalage de l'image glissée par rapport à la position de glissement.
GetIcon	Crée une icône à partir d’une image et un masque dans une liste d’images.
GetIconSize	Obtient les dimensions des images d’une liste d’images. Toutes les images d’une liste d’images ont les mêmes dimensions.
GetImageCount	Obtient le nombre d’images dans une liste d’images.
GetImageInfo	Obtient des informations sur une image.
GetImageRect	Obtient le rectangle englobant d’une image.
GetItemFlags	Obtient les indicateurs d’une image.
GetOverlayImage	Récupère une image spécifiée à partir de la liste d’images utilisées comme masques de superposition.
Fusionner	Crée une image en combinant deux images existantes. Cette méthode crée également une liste d’images dans laquelle stocker l’image.
Supprimer	Supprime une image d’une liste d’images.
Remplacer	Remplace une image dans une liste d’images par une nouvelle image.
ReplaceIcon	Remplace une image par une icône ou un curseur.
SetBkColor	Définit la couleur d’arrière-plan d’une liste d’images. Cette méthode fonctionne uniquement si vous ajoutez une icône à la liste d’images ou si vous utilisez la méthode IImageList::AddMasked pour ajouter une bitmap en noir et blanc. Sans masque, l’image entière dessine et la couleur d’arrière-plan n’est pas visible.
SetDragCursorImage	Crée une image glisser en combinant l’image spécifiée, qui est généralement une image de curseur de souris, avec l’image de glisser actuelle.
SetIconSize	Définit les dimensions des images dans une liste d’images et supprime toutes les images de la liste.
SetImageCount	Redimensionne une liste d’images existante.
SetOverlayImage	Ajoute une image spécifiée à la liste des images utilisées comme masques de superposition. Une liste d’images peut avoir jusqu’à quatre masques de superposition dans Common Controls version 4.70 et antérieure, et jusqu’à 15 dans la version 4.71 ou ultérieure. La méthode affecte un index de masque de superposition à l’image spécifiée.

Structures

Rubrique	Contenu
IMAGEINFO	Contient des informations sur une image dans une liste d’images. Cette structure est utilisée avec la fonction IImageList::GetImageInfo .
IMAGELISTDRAWPARAMS	Contient des informations sur une opération de dessin de liste d’images et est utilisé avec la fonction IImageList::D raw .