commctrl.h


ImageList_DrawEx

La función ImageList_DrawEx traza un ítem de una lista de imágenes en el contexto de dispositivo especificado. La función usa el estipo de trazado especificado y mezcla la imagen con el color especificado.

Sintaxis

BOOL ImageList_DrawEx(
    HIMAGELIST himl,  // manipulador de lista de imágenes
    int i,            // índice de la imagen a dibujar
    HDC hdcDst,       // manipulador del contexto de dispositivo de destino
    int x,            // coordenada x para dibujar
    int y,            // coordenada y para dibujar
    int dx,           // anchura de la imagen
    int dy,           // altura de la imagen
    COLORREF rgbBk,   // color de fondo de la imagen
    COLORREF rgbFg,   // color de primer plano de la imagen
    UINT fStyle       // estilo de trazado
   );

Parámetros

himl
Manipulador de la lista de imágenes.
i
Especifica el índice de la imagen a dibujar.
hdcDst
Manipulador del contexto de dispositivo de destino.
x
Especifica la coordenada x en la que se trazará en el contexto de dispositivo especificado.
y
Especifica la coordenada y en la que se trazará en el contexto de dispositivo especificado.
rgbBk
Color de fondo de la imagen. Este parámetro puede ser un valor RGB definido por la aplicación o uno de los siguientes valores:
Value Meaning
CLR_NONE Sin color de fondo. La imagen se traza transparentemente.
CLR_DEFAULT Color de fondo por defecto. La imagen se traza usando el color de fondo de la lista de imágenes.

Este parámetro sólo se usa si la lista de imágenes identificada pòr himl fue creada con el valor ILC_MASK.

rgbFg
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 Sin color de mezcla. La imagen se mezcla con el color del contexto de dispositivo de destino.
CLR_DEFAULT Color de primer plano por defecto. La imagen se traza usando el color de resaltado de sistema como el color de primer plano.

Este parámetro se usa sólo si fStyle incluye el valor ILD_BLEND25 o ILD_BLEND50.

fStyle
Bandera que especifica el estilo de trazado. Este parámetro puede ser uno o más de los siguientes valores:
Valor Significado
ILD_BLEND25,
ILD_FOCUS
Traza la imagen, mezclada en un 25% con el color de sistema resaltado. Este valor no tiene efecto si la lista de imágenes no contiene una máscara.
ILD_BLEND50,
ILD_SELECTED,
ILD_BLEND
Traza la imagen, mezclada en un 50% con el color de sistema resaltado. Este valor no tiene efecto si la lista de imágenes no contiene una máscara.
ILD_MASK Traza la máscara.
ILD_NORMAL Traza la imagen usando el color de fonto para la lista de imágenes. Si el color de fondo es el valor CLR_NONE, la imagen es trazada transparentemente usando la máscara.
ILD_TRANSPARENT Traza la imagen transparentemente usando la máscara, independientemente del color de fondo. Este valor no tiene efecto si la lista de imágenes no contiene una máscara.

Valor de retorno

Si la macro tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero.