Estructura IMAGELISTDRAWPARAMS (commctrl.h)

Contiene información sobre una operación de dibujo de lista de imágenes y se usa con la función IImageList::D raw .

Syntax

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

Tipo: DWORD de

Tamaño de esta estructura, en bytes.

himl

Tipo: HIMAGELIST

Identificador de la lista de imágenes que contiene la imagen que se va a dibujar.

i

Tipo: int

Índice de base cero de la imagen que se va a dibujar.

hdcDst

Tipo: HDC

Identificador del contexto del dispositivo de destino.

x

Tipo: int

Coordenada x que especifica dónde se dibuja la imagen.

y

Tipo: int

Coordenada y que especifica dónde se dibuja la imagen.

cx

Tipo: int

Valor que especifica el número de píxeles que se van a dibujar, en relación con la esquina superior izquierda de la operación de dibujo, tal como se especifica en xBitmap e yBitmap. Si cx y cy son cero, Draw dibuja toda la sección válida. El método no garantiza que los parámetros sean válidos.

cy

Tipo: int

Valor que especifica el número de píxeles que se van a dibujar, en relación con la esquina superior izquierda de la operación de dibujo, tal como se especifica en xBitmap e yBitmap. Si cx y cy son cero, Draw dibuja toda la sección válida. El método no garantiza que los parámetros sean válidos.

xBitmap

Tipo: int

Coordenada x que especifica la esquina superior izquierda de la operación de dibujo en referencia a la propia imagen. Los píxeles de la imagen que se encuentran a la izquierda de xBitmap y encima de yBitmap no aparecen.

yBitmap

Tipo: int

Coordenada y que especifica la esquina superior izquierda de la operación de dibujo en referencia a la propia imagen. Los píxeles de la imagen que se encuentran a la izquierda de xBitmap y encima de yBitmap no aparecen.

rgbBk

Tipo: COLORREF

Color de fondo de la imagen. Este parámetro puede ser un valor RGB definido por la aplicación o uno de los valores siguientes.

rgbFg

Tipo: COLORREF

Color de primer plano de la imagen. Este miembro solo se usa si fStyle incluye la marca ILD_BLEND25 o ILD_BLEND50 . Este parámetro puede ser un valor RGB definido por la aplicación o uno de los siguientes valores:

fStyle

Tipo: UINT

Marca que especifica el estilo de dibujo y, opcionalmente, la imagen de superposición. Consulte la sección de comentarios al final de este tema para obtener información sobre la imagen de superposición. Este miembro puede contener una o varias marcas de dibujo de lista de imágenes.

dwRop

Tipo: DWORD de

Valor que especifica un código de operación de trama. Estos códigos definen cómo se combinarán los datos de color del rectángulo de origen con los datos de color del rectángulo de destino para lograr el color final. Este miembro se omite si fStyle no incluye la marca ILD_ROP . Algunos códigos de operación ráster comunes incluyen:

fState

Tipo: DWORD de

Marca que especifica el estado de dibujo. Este miembro puede contener una o varias marcas de estado de lista de imágenes. Debe usar comctl32.dll versión 6 para usar este miembro. Vea los comentarios.

Frame

Tipo: DWORD de

Se usa con el efecto de combinación alfa .

Cuando se usa con ILS_ALPHA, este miembro contiene el valor del canal alfa. Este valor puede ser de 0 a 255, siendo 0 completamente transparente y 255 siendo completamente opaco.

Debe usar comctl32.dll versión 6 para usar este miembro. Vea los comentarios.

crEffect

Tipo: DWORD de

Color utilizado para los efectos de brillo y sombra . Debe usar comctl32.dll versión 6 para usar este miembro. Vea los comentarios.

Observaciones

Una imagen de superposición es una imagen que se dibuja sobre la imagen principal especificada en el miembro i de esta estructura. Para especificar una imagen de superposición, use el operador OR bit a bit para combinar fStyle con la macro INDEXTOOVERLAYMASK , pasando el índice basado en una de la imagen de superposición en la macro. Esta imagen debe haberse especificado previamente como una imagen de superposición mediante la API de ImageList_SetOverlayImage .

Para extraer la imagen de superposición del fStyle, use el operador AND bit a bit para enmascarar fStyle con el valor de ILD_OVERLAYMASK .

Comctl32.dll versión 6 no se puede redistribuir. Para usar Comctl32.dll versión 6, debe especificarla en un manifiesto. Para obtener más información sobre los manifiestos, vea Habilitación de estilos visuales.

Requisitos