IMAGELISTDRAWPARAMS, structure (commctrl.h)

Contient des informations sur une opération de dessin de liste d’images et est utilisée 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;

Members

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 vers le contexte de l’appareil de destination.

x

Type : int

Coordonnée x qui spécifie 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, draw dessine l’intégralité 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, draw dessine l’intégralité 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 l’angle supérieur gauche de l’opération de dessin en référence à l’image elle-même. Les pixels de l’image à gauche de xBitmap et au-dessus de yBitmap n’apparaissent pas.

yBitmap

Type : int

Coordonnée y qui spécifie l’angle supérieur gauche de l’opération de dessin en référence à l’image elle-même. Les pixels de l’image à 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.

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 :

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 de ILD_ROP . Voici quelques codes d’opération raster courants :

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. 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, avec 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 de lumière et d’ombre . Vous devez utiliser comctl32.dll version 6 pour utiliser ce membre. Consultez les remarques.

Remarques

Une image de superposition est une image dessinée au-dessus de l’image primaire 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 à partir de 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