Partager via

STRUCTURE IMAGELISTDRAWPARAMS (commoncontrols.h)

  • Article

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;

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 zéro, dessine l’ensemble de la section valide. 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 zéro, dessine l’ensemble de la section valide. 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. Consultez la section commentaires à la fin de cette rubrique pour plus d’informations sur l’image de superposition. 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 pour 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é 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 OR booléen. Inverse la couleur résultante.
PATCOPY
 Copie le modèle spécifié dans l’image 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 du motif avec les couleurs du 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 OR booléen.
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 de 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. Consultez les remarques.

Frame

Type : DWORD

Utilisé avec l’effet de fusion alpha .

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

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

crEffect

Type : DWORD

Couleur utilisée pour les effets d’ombre et de lumière. Vous devez utiliser comctl32.dll version 6 pour utiliser ce membre. Consultez les remarques.

Notes

Une image superposée est une image 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 de superposition du 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 la 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 commoncontrols.h (include Commctrl.h)