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 :

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 :

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 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