Estructura IMAGELISTDRAWPARAMS (commctrl.h)

  • Artículo

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

Sintaxis

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

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

Controlar el 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.

Valor Significado
CLR_DEFAULT
 Color de fondo predeterminado. La imagen se dibuja con el color de fondo de la lista de imágenes.
CLR_NONE
 Ningún color de fondo. La imagen se dibuja de forma transparente.

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 valores siguientes:

Valor Significado
CLR_DEFAULT
 Color de primer plano predeterminado. La imagen se dibuja con el color de resaltado del sistema como color de primer plano.
CLR_NONE
 Ningún color de mezcla. La imagen se combina con el color del contexto del dispositivo de destino.

fStyle

Tipo: UINT

Marca que especifica el estilo de dibujo y, opcionalmente, la imagen de superposición. Consulte la sección 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

Valor que especifica un código de operación ráster. 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:

Valor Significado
OSCURIDAD
 Rellena el rectángulo de destino con el color asociado al índice cero en la paleta física. (este color es negro para la paleta física predeterminada).
DSTINVERT
 Invierte el rectángulo de destino.
MERGECOPY
 Combina los colores del rectángulo de origen con el patrón especificado mediante el operador BOOLEAN AND .
MERGEPAINT
 Combina los colores de rectángulo de origen invertidos con los colores del rectángulo de destino mediante el operador OR booleano.
NOTSRCCOPY
 Copia el rectángulo de origen invertido en el destino.
NOTSRCERASE
 Combina los colores del rectángulo de origen y de destino mediante el operador OR booleano. Invierte el color resultante.
PATCOPY
 Copia el patrón especificado en el mapa de bits de destino.
PATINVERT
 Combina los colores de patrón especificados con los colores del rectángulo de destino mediante el operador XOR booleano.
PATPAINT
 Combina los colores de patrón con los colores de rectángulo de origen invertidos y combina el resultado con los colores del rectángulo de destino mediante el operador OR booleano.
SRCAND
 Combina los colores del rectángulo de origen y de destino mediante el operador BOOLEAN AND .
SRCCOPY
 Copia el rectángulo de origen directamente en el rectángulo de destino.
SRCERASE
 Combina los colores invertidos del rectángulo de destino con los colores de rectángulo de origen mediante el operador BOOLEAN AND .
SRCINVERT
 Combina los colores del rectángulo de origen y destino mediante el operador XOR booleano.
SRCPAINT
 Combina los colores del rectángulo de origen y de destino mediante el operador OR booleano.
BLANCURA
 Rellena el rectángulo de destino con el color asociado al índice uno de la paleta física. Este color es blanco para la paleta física predeterminada.

fState

Tipo: DWORD

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

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 ir de 0 a 255, donde 0 es completamente transparente y 255 es completamente opaco.

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

crEffect

Tipo: DWORD

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

Comentarios

Una imagen superpuesta 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 uno de la imagen de superposición en la macro. Esta imagen debe haberse especificado previamente como una imagen superpuesta mediante la API de ImageList_SetOverlayImage .

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

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

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado commctrl.h (incluya Commctrl.h)