Lire en anglais

Partager via

Listes d’images

  • Article

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

Aperçus

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

Fonctions

Sujet 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 image ou des images à une liste d’images.
ImageList_AddMasked Ajoute une image ou des images à une liste d’images, générant un masque à partir de la 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 celui-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 en cours de déplacement 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 déplacée.
ImageList_Draw Dessine un élément de liste d’images dans le contexte d’appareil spécifié.
ImageList_DrawEx Dessine un élément de liste d’images 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 Termine une opération de glisser.
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 la position de glisser actuelle et le décalage de l’image de glisser par rapport à la position de glisser.
ImageList_GetIcon Crée une icône à partir d’une image et d’un masque dans une liste d’images.
ImageList_GetIconSize 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.
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 la 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 une bitmap noire et blanche. 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 d’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 des images à utiliser comme masques de superposition. Une liste d’images peut comporter jusqu’à quatre masques de superposition dans la version 4.70 et antérieure 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

Sujet 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 en fonction d’une image et d’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

Sujet Contenu
IImageList Expose des méthodes qui manipulent et interagissent avec des listes d’images.
Pour utiliser IImageList, spécifiez Comctl32.dll version 6 dans le manifeste. Si ce n’est pas le cas, 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éthode

Sujet Contenu
Ajouter Ajoute une image ou des images à une liste d’images.
AddMasked Ajoute une image ou des images à une liste d’images, générant un masque à partir de la bitmap spécifiée.
BeginDrag Commence à faire glisser une image.
Cloner Clone une liste d’images existante.
Copier Copie des images d’une liste d’images donnée.
dragEnter Verrouille les mises à jour de la fenêtre spécifiée pendant une opération de glisser et affiche l’image à 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 mettre à jour.
DragMove Déplace l’image en cours de déplacement 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 déplacée.
dessiner Dessine un élément de liste d’images dans le contexte d’appareil spécifié.
endDrag Termine une opération de glisser.
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 la position de glisser actuelle et le décalage de l’image de glisser par rapport à la position de glisser.
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 dans la liste des 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 utilisez la méthode IImageList ::AddMasked pour ajouter une bitmap noire et blanche. 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 comporter jusqu’à quatre masques de superposition dans Common Controls version 4.70 et versions 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

Sujet 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ée avec la fonction IImageList ::D raw.