ImageList_Draw, fonction (commctrl.h)

  • Article

Dessine un élément de liste d’images dans le contexte d’appareil spécifié.

Syntaxe

BOOL ImageList_Draw(
  HIMAGELIST himl,
  int        i,
  HDC        hdcDst,
  int        x,
  int        y,
  UINT       fStyle
);

Paramètres

himl

Type : HIMAGELIST

Handle de la liste d’images.

i

Type : int

Index de base zéro 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é.

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 mise en surbrillance du système. 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 mise en surbrillance du système. 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
Ensemble d’API ext-ms-win-shell-comctl32-init-l1-1-1 (introduit dans Windows 10, version 10.0.14393)