Compartir a través de

Función ImageList_Draw (commctrl.h)

  • Artículo

Dibuja un elemento de lista de imágenes en el contexto de dispositivo especificado.

Sintaxis

BOOL ImageList_Draw(
  HIMAGELIST himl,
  int        i,
  HDC        hdcDst,
  int        x,
  int        y,
  UINT       fStyle
);

Parámetros

himl

Tipo: HIMAGELIST

Identificador de la lista de imágenes.

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

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 resaltado del sistema. 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 resaltado del sistema. 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
Conjunto de API ext-ms-win-shell-comctl32-init-l1-1-1 (introducido en Windows 10, versión 10.0.14393)