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 même taille, dont chacune peut ê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.
_Ajouter ImageList Ajoute une image ou des images à une liste d’images.
_AddMasked ImageList Ajoute une ou des images à une liste d’images, en générant un masque à partir de l’image bitmap spécifiée.
_BeginDrag ImageList Commence à faire glisser une image.
ImageList _ CoCreateInstance Crée une instance unique d’un ImageList et retourne un pointeur d’interface vers celui-ci.
_Copie ImageList Copie des images dans une liste d’images donnée.
_Créer ImageList Crée une nouvelle liste d’images.
_Supprimer ImageList Détruit une liste d’images.
ImageList _ DragEnter Affiche l’image de glissement à la position spécifiée dans la fenêtre.
_DragLeave ImageList Déverrouille la fenêtre spécifiée et masque l’image de glissement, ce qui permet la mise à jour de la fenêtre.
_DragMove ImageList Déplace l’image glissé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 ImageList Affiche ou masque l’image glissée.
_Dessin ImageList Dessine un élément de liste d’images dans le contexte de périphérique spécifié.
_DrawEx ImageList Dessine un élément de liste d’images dans le contexte de périphérique spécifié. La fonction utilise le style de dessin spécifié et fusionne l’image avec la couleur spécifiée.
_DrawIndirect ImageList Dessine une image de liste d’images basée sur une structure IMAGELISTDRAWPARAMS .
_Doublon ImageList Crée un doublon d’une liste d’images existante.
_EndDrag ImageList Termine une opération glisser.
_GetBkColor ImageList Récupère la couleur d’arrière-plan actuelle pour une liste d’images.
_GetDragImage ImageList Récupère la liste d’images temporaire qui est utilisée pour l’image de glissement. 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 ImageList Crée une icône à partir d’une image et d’un masque dans une liste d’images.
_GetIconSize ImageList Récupère les dimensions des images dans une liste d’images. Toutes les images d’une liste d’images ont les mêmes dimensions.
_GetImageCount ImageList Récupère le nombre d’images dans une liste d’images.
_GetImageInfo ImageList Récupère des informations sur une image.
_LoadImage ImageList Crée une liste d’images à partir de la bitmap spécifiée.
_Fusion ImageList Crée une image en combinant deux images existantes. La fonction crée également une nouvelle liste d’images dans laquelle stocker l’image.
_Lecture ImageList Lit une liste d’images à partir d’un flux.
_ReadEx ImageList Lit une liste d’images à partir d’un flux et retourne une interface à la liste d’images.
ImageList _ Supprimer Supprime une image d’une liste d’images.
ImageList- _ remplacer Remplace une image dans une liste d’images par une nouvelle image.
_ReplaceIcon ImageList Remplace une image par une icône ou un curseur.
_SetBkColor ImageList Définit la couleur d’arrière-plan d’une liste d’images. Cette fonction ne fonctionne que si vous ajoutez une icône ou utilisez ImageList _ AddMasked avec un bitmap noir et blanc. Sans masque, la totalité de l’image est dessinée ; par conséquent, la couleur d’arrière-plan n’est pas visible.
_SetColorTable ImageList Définit la table des couleurs pour une liste d’images.
_SetDragCursorImage ImageList Crée une image de glissement en combinant l’image spécifiée (généralement une image de curseur de la souris) avec l’image de glissement actuelle.
_SetIconSize ImageList Définit les dimensions des images dans une liste d’images et supprime toutes les images de la liste.
_SetImageCount ImageList Redimensionne une liste d’images existante.
_SetOverlayImage ImageList Ajoute une image spécifiée à la liste d’images à utiliser comme masques de superposition. Une liste d’images peut comporter jusqu’à quatre masques de superposition dans la version 4,70 et les versions antérieures, et jusqu’à 15 dans la version 4,71. La fonction affecte un index de masque de recouvrement à l’image spécifiée.
_Écriture ImageList Écrit une liste d’images dans un flux.
_WriteEx ImageList Écrit une liste d’images dans un flux.

Macros

Rubrique Contenu
_Addicon ImageList Ajoute une icône ou un curseur à une liste d’images. ImageList _ AddIcon appelle la fonction ImageList _ ReplaceIcon .
_ExtractIcon ImageList Appelle la fonction ImageList _ GetIcon pour créer une icône ou un curseur à partir d’une image et d’un masque dans une liste d’images.
_LoadBitmap ImageList 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 de _ dessin ImageList puisse l’utiliser.

Interfaces

Rubrique Contenu
IImageList Expose des 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 pourrait afficher un comportement imprévisible. Pour plus d’informations sur les manifestes, consultez activation des styles visuels.

Méthodes

Rubrique Contenu
Ajouter Ajoute une image ou des images à une liste d’images.
AddMasked Ajoute une ou des images à une liste d’images, en générant un masque à partir de l’image bitmap spécifiée.
BeginDrag Commence à faire glisser une image.
Répliqué Clone une liste d’images existante.
Reprographie Copie les images à partir d’une liste d’images donnée.
DragEnter Verrouille les mises à jour de la fenêtre spécifiée pendant une opération glisser et affiche l’image de glissement à la position spécifiée dans la fenêtre.
DragLeave Déverrouille la fenêtre spécifiée et masque l’image du glissement, ce qui permet à la fenêtre d’être mise à jour.
DragMove Déplace l’image glissé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 glissée.
Dessin Dessine un élément de liste d’images dans le contexte de périphérique spécifié.
EndDrag Termine une opération glisser.
GetBkColor Obtient la couleur d’arrière-plan actuelle pour une liste d’images.
GetDragImage Obtient la liste d’images temporaires utilisée pour l’image de glissement. 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 d’un masque dans une liste d’images.
GetIconSize Obtient les dimensions des images dans 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 de la liste des images utilisées comme masques de superposition.
Fusion Crée une image en combinant deux images existantes. Cette méthode crée également une nouvelle liste d’images dans laquelle stocker l’image.
Supprimer Supprime une image d’une liste d’images.
Lieu 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 utilisez la méthode IImageList :: AddMasked pour ajouter une image bitmap noir et blanc. Sans masque, l’image entière est dessinée et la couleur d’arrière-plan n’est pas visible.
SetDragCursorImage Crée une image de glissement en combinant l’image spécifiée, qui est généralement une image de curseur de la souris, avec l’image de glissement 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 comporter jusqu’à quatre masques de superposition dans les contrôles communs version 4,70 et antérieures, 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 .