IMAGELISTDRAWPARAMS, structure (commctrl.h)

Contient des informations sur une opération de dessin de liste d’images et est utilisé avec la fonction IImageList::D raw .

Syntaxe

typedef struct _IMAGELISTDRAWPARAMS {
  DWORD      cbSize;
  HIMAGELIST himl;
  int        i;
  HDC        hdcDst;
  int        x;
  int        y;
  int        cx;
  int        cy;
  int        xBitmap;
  int        yBitmap;
  COLORREF   rgbBk;
  COLORREF   rgbFg;
  UINT       fStyle;
  DWORD      dwRop;
  DWORD      fState;
  DWORD      Frame;
  COLORREF   crEffect;
} IMAGELISTDRAWPARAMS, *LPIMAGELISTDRAWPARAMS;

Membres

cbSize

Type : DWORD

Taille de cette structure, en octets.

himl

Type : HIMAGELIST

Handle de la liste d’images qui contient l’image à dessiner.

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 qui spécifie l’emplacement où l’image est dessinée.

y

Type : int

Coordonnée y qui spécifie l’emplacement où l’image est dessinée.

cx

Type : int

Valeur qui spécifie le nombre de pixels à dessiner, par rapport au coin supérieur gauche de l’opération de dessin, comme spécifié par xBitmap et yBitmap. Si cx et cy sont nuls, Draw dessine la section valide entière. La méthode ne garantit pas que les paramètres sont valides.

cy

Type : int

Valeur qui spécifie le nombre de pixels à dessiner, par rapport au coin supérieur gauche de l’opération de dessin, comme spécifié par xBitmap et yBitmap. Si cx et cy sont nuls, Draw dessine la section valide entière. La méthode ne garantit pas que les paramètres sont valides.

xBitmap

Type : int

Coordonnée x qui spécifie le coin supérieur gauche de l’opération de dessin en référence à l’image elle-même. Les pixels de l’image qui se trouvent à gauche de xBitmap et au-dessus de yBitmap n’apparaissent pas.

yBitmap

Type : int

Coordonnée y qui spécifie le coin supérieur gauche de l’opération de dessin en référence à l’image elle-même. Les pixels de l’image qui se trouvent à gauche de xBitmap et au-dessus de yBitmap n’apparaissent pas.

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_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.
CLR_NONE	Aucune couleur d’arrière-plan. L’image est dessinée en toute transparence.

rgbFg

Type : COLORREF

Couleur de premier plan de l’image. Ce membre est utilisé uniquement si fStyle inclut l’indicateur ILD_BLEND25 ou ILD_BLEND50 . Ce paramètre peut être une valeur RVB définie par l’application ou l’une des valeurs suivantes :

Valeur	Signification
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.
CLR_NONE	Aucune couleur de fusion. L’image est fusionnée avec la couleur du contexte de l’appareil de destination.

fStyle

Type : UINT

Indicateur spécifiant le style de dessin et, éventuellement, l’image superposée. Pour plus d’informations sur l’image de superposition, consultez la section commentaires à la fin de cette rubrique. Ce membre peut contenir un ou plusieurs indicateurs de dessin de liste d’images.

dwRop

Type : DWORD

Valeur spécifiant un code d’opération raster. Ces codes définissent la façon dont les données de couleur du rectangle source seront combinées avec les données de couleur du rectangle de destination afin d’obtenir la couleur finale. Ce membre est ignoré si fStyle n’inclut pas l’indicateur ILD_ROP . Voici quelques codes d’opération raster courants :

Valeur	Signification
NOIRCEUR	Remplit le rectangle de destination à l’aide de la couleur associée à l’index zéro dans la palette physique. (Cette couleur est le noir sur la palette physique par défaut.)
DSTINVERT	Inverse le rectangle de destination.
MERGECOPY	Fusionne les couleurs du rectangle source avec le modèle spécifié à l’aide de l’opérateur Boolean AND .
MERGEPAINT	Fusionne les couleurs du rectangle source inversées avec les couleurs du rectangle de destination à l’aide de l’opérateur BOOlean OR .
NOTSRCCOPY	Copie le rectangle source inversé vers la destination.
NOTSRCERASE	Combine les couleurs du rectangle source et de destination à l’aide de l’opérateur Boolean OR . Inverse la couleur résultante.
PATCOPY	Copie le modèle spécifié dans la bitmap de destination.
PATINVERT	Combine les couleurs de motif spécifiées avec les couleurs du rectangle de destination à l’aide de l’opérateur XOR booléen.
PATPAINT	Combine les couleurs de motif avec les couleurs de rectangle source inversées et combine le résultat avec les couleurs du rectangle de destination à l’aide de l’opérateur BOOlean OR .
SRCAND	Combine les couleurs du rectangle source et de destination à l’aide de l’opérateur Boolean AND .
SRCCOPY	Copie le rectangle source directement dans le rectangle de destination.
SRCERASE	Combine les couleurs inversées du rectangle de destination avec les couleurs du rectangle source à l’aide de l’opérateur Boolean AND .
SRCINVERT	Combine les couleurs du rectangle source et de destination à l’aide de l’opérateur XOR booléen.
SRCPAINT	Combine les couleurs du rectangle source et de destination à l’aide de l’opérateur Boolean OR .
BLANCHEUR	Remplit le rectangle de destination à l’aide de la couleur associée à l’index 1 dans la palette physique. Cette couleur est blanche pour la palette physique par défaut.

fState

Type : DWORD

Indicateur qui spécifie l’état du dessin. Ce membre peut contenir un ou plusieurs indicateurs d’état de liste d’images. Vous devez utiliser comctl32.dll version 6 pour utiliser ce membre. Voir les remarques.

Frame

Type : DWORD

Utilisé avec l’effet de fusion alpha .

Lorsqu’il est utilisé avec ILS_ALPHA, ce membre détient la valeur du canal alpha. Cette valeur peut être comprise entre 0 et 255, 0 étant complètement transparent et 255 complètement opaque.

Vous devez utiliser comctl32.dll version 6 pour utiliser ce membre. Voir les remarques.

crEffect

Type : DWORD

Couleur utilisée pour les effets de lueur et d’ombre . Vous devez utiliser comctl32.dll version 6 pour utiliser ce membre. Voir les remarques.

Notes

Une image superposée est une image qui est dessinée au-dessus de l’image principale spécifiée dans le membre i de cette structure. Pour spécifier une image de superposition, utilisez l’opérateur OR au niveau du bit pour combiner fStyle avec la macro INDEXTOOVERLAYMASK , en passant l’index de base unique de l’image de superposition dans la macro. Cette image doit avoir été spécifiée précédemment en tant qu’image de superposition à l’aide de l’API ImageList_SetOverlayImage .

Pour extraire l’image superposée de l’élément fStyle, utilisez l’opérateur AND au niveau du bit pour masquer fStyle avec la valeur ILD_OVERLAYMASK .

Comctl32.dll version 6 n’est pas redistribuable.. Pour utiliser Comctl32.dll version 6, vous devez le spécifier dans un manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.

Spécifications

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	commctrl.h (include Commctrl.h)