función ImageList_DrawEx (commctrl.h)

Dibuja un elemento de lista de imágenes en el contexto de dispositivo especificado. La función usa el estilo de dibujo especificado y combina la imagen con el color especificado.

Sintaxis

BOOL ImageList_DrawEx(
  HIMAGELIST himl,
  int        i,
  HDC        hdcDst,
  int        x,
  int        y,
  int        dx,
  int        dy,
  COLORREF   rgbBk,
  COLORREF   rgbFg,
  UINT       fStyle
);

Parámetros

himl

Tipo: HIMAGELIST

Identificador de la lista de imágenes

i

Tipo: int

Índice de la imagen que se va a dibujar.

hdcDst

Tipo: HDC

Controlar el contexto del dispositivo de destino.

x

Tipo: int

Coordenada x en la que se va a dibujar dentro del contexto de dispositivo especificado.

y

Tipo: int

Coordenada y en la que se va a dibujar dentro del contexto de dispositivo especificado.

dx

Tipo: int

Ancho de la parte de la imagen que se va a dibujar en relación con la esquina superior izquierda de la imagen. Si dx y dy son cero, la función dibuja toda la imagen. La función no garantiza que los parámetros sean válidos.

dy

Tipo: int

Alto de la parte de la imagen que se va a dibujar, en relación con la esquina superior izquierda de la imagen. Si dx y dy son cero, la función dibuja toda la imagen. La función no garantiza que los parámetros sean válidos.

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_NONE	Ningún color de fondo. La imagen se dibuja de forma transparente.
CLR_DEFAULT	Color de fondo predeterminado. La imagen se dibuja con el color de fondo de la lista de imágenes.

rgbFg

Tipo: COLORREF

Color de primer plano 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_NONE	Ningún color de mezcla. La imagen se combina con el color del contexto del dispositivo de destino.
CLR_DEFAULT	Color de primer plano predeterminado. La imagen se dibuja con el color de resaltado del sistema como color de primer plano.

fStyle

Tipo: UINT

El estilo de dibujo y, opcionalmente, la imagen de superposición. Para obtener información sobre cómo especificar un índice de imagen de superposición, vea la sección comentarios al final de este tema. Este parámetro puede ser una combinación de un índice de imagen de superposición y uno o varios de los valores siguientes:

Valor	Significado
ILD_BLEND
ILD_BLEND25	Dibuja la imagen, mezclando el 25 por ciento con el color de mezcla especificado por rgbFg. Este valor no tiene ningún efecto si la lista de imágenes no contiene una máscara.
ILD_BLEND50	Dibuja la imagen, mezclando el 50 por ciento con el color de mezcla especificado por rgbFg. Este valor no tiene ningún efecto si la lista de imágenes no contiene una máscara.
ILD_FOCUS
ILD_IMAGE	Establezca esta marca si la superposición no requiere que se dibuje una máscara. Esta marca hace que ImageList_DrawEx dibujar solo la imagen, ignorando la máscara.
ILD_MASK	Dibuja la máscara.
ILD_NORMAL	Dibuja la imagen con el color de fondo de la lista de imágenes. Si el color de fondo es el valor CLR_NONE, la imagen se dibuja de forma transparente mediante la máscara.
ILD_SELECTED
ILD_TRANSPARENT	Dibuja la imagen de forma transparente mediante la máscara, independientemente del color de fondo. Este valor no tiene ningún efecto si la lista de imágenes no contiene una máscara.

Valor devuelto

Tipo: BOOL

Devuelve un valor distinto de cero si se ejecuta correctamente o cero en caso contrario.

Comentarios

Una imagen de superposición se dibuja de forma transparente sobre la imagen principal especificada en el parámetro i . Para especificar una imagen de superposición en el parámetro fStyle , use la macro INDEXTOOVERLAYMASK para desplazar el índice basado en uno de la imagen de superposición. Use el operador OR para combinar lógicamente el valor devuelto de la macro con las marcas de estilo de dibujo especificadas en el parámetro fStyle . Primero debe especificar esta imagen como una imagen de superposición mediante la función ImageList_SetOverlayImage .

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	commctrl.h
Library	Comctl32.lib
Archivo DLL	Comctl32.dll