ImageList_DrawEx, fonction (commctrl.h)

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.

Syntaxe

BOOL ImageList_DrawEx(
  HIMAGELIST himl,
  int        i,
  HDC        hdcDst,
  int        x,
  int        y,
  int        dx,
  int        dy,
  COLORREF   rgbBk,
  COLORREF   rgbFg,
  UINT       fStyle
);

Paramètres

himl

Type : HIMAGELIST

Handle de la liste d’images

i

Type : int

Index de l’image à dessiner.

hdcDst

Type : HDC

Handle du contexte de l’appareil de destination.

x

Type : int

Coordonnée x à laquelle dessiner dans le contexte d’appareil spécifié.

y

Type : int

Coordonnée y à laquelle dessiner dans le contexte d’appareil spécifié.

dx

Type : int

Largeur de la partie de l’image à dessiner par rapport au coin supérieur gauche de l’image. Si dx et dy sont zéro, la fonction dessine l’image entière. La fonction ne garantit pas que les paramètres sont valides.

dy

Type : int

Hauteur de la partie de l’image à dessiner par rapport au coin supérieur gauche de l’image. Si dx et dy sont zéro, la fonction dessine l’image entière. La fonction ne garantit pas que les paramètres sont valides.

rgbBk

Type : COLORREF

Couleur d’arrière-plan de l’image. Ce paramètre peut être une valeur RVB définie par l’application ou l’une des valeurs suivantes :

Valeur	Signification
CLR_NONE	Aucune couleur d’arrière-plan. L’image est dessinée en toute transparence.
CLR_DEFAULT	Couleur d’arrière-plan par défaut. L’image est dessinée à l’aide de la couleur d’arrière-plan de la liste d’images.

rgbFg

Type : COLORREF

Couleur de premier plan de l’image. Ce paramètre peut être une valeur RVB définie par l’application ou l’une des valeurs suivantes :

Valeur	Signification
CLR_NONE	Aucune couleur de fusion. L’image est fusionnée avec la couleur du contexte de l’appareil de destination.
CLR_DEFAULT	Couleur de premier plan par défaut. L’image est dessinée à l’aide de la couleur de mise en surbrillance système comme couleur de premier plan.

fStyle

Type : UINT

Style de dessin et, éventuellement, image de superposition. Pour plus d’informations sur la spécification d’un index d’image de superposition, consultez la section commentaires à la fin de cette rubrique. Ce paramètre peut être une combinaison d’un index d’image de superposition et d’une ou plusieurs des valeurs suivantes :

Valeur	Signification
ILD_BLEND
ILD_BLEND25	Dessine l’image, en fusionnant 25 % avec la couleur de fusion spécifiée par rgbFg. Cette valeur n’a aucun effet si la liste d’images ne contient pas de masque.
ILD_BLEND50	Dessine l’image, en fusionnant 50 % avec la couleur de fusion spécifiée par rgbFg. Cette valeur n’a aucun effet si la liste d’images ne contient pas de masque.
ILD_FOCUS
ILD_IMAGE	Définissez cet indicateur si la superposition ne nécessite pas de dessin de masque. Cet indicateur entraîne ImageList_DrawEx à dessiner uniquement l’image, en ignorant le masque.
ILD_MASK	Dessine le masque.
ILD_NORMAL	Dessine l’image à l’aide de la couleur d’arrière-plan de la liste d’images. Si la couleur d’arrière-plan est la valeur CLR_NONE, l’image est dessinée en toute transparence à l’aide du masque.
ILD_SELECTED
ILD_TRANSPARENT	Dessine l’image en toute transparence à l’aide du masque, quelle que soit la couleur d’arrière-plan. Cette valeur n’a aucun effet si la liste d’images ne contient pas de masque.

Valeur retournée

Type : BOOL

Retourne une valeur différente de zéro en cas de réussite, ou zéro dans le cas contraire.

Remarques

Une image superposée est dessinée en toute transparence sur l’image principale spécifiée dans le paramètre i . Pour spécifier une image de superposition dans le paramètre fStyle , utilisez la macro INDEXTOOVERLAYMASK pour déplacer l’index de base un de l’image de superposition. Utilisez l’opérateur OR pour combiner logiquement la valeur de retour de la macro avec les indicateurs de style de dessin spécifiés dans le paramètre fStyle . Vous devez d’abord spécifier cette image en tant qu’image superposée à l’aide de la fonction ImageList_SetOverlayImage .

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