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:

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:

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 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