função ImageList_DrawEx (commctrl.h)

Desenha um item da lista de imagens no contexto do dispositivo especificado. A função usa o estilo de desenho especificado e combina a imagem com a cor especificada.

Sintaxe

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

Um identificador para a lista de imagens

i

Tipo: int

O índice da imagem a ser desenhada.

hdcDst

Tipo: HDC

Um identificador para o contexto do dispositivo de destino.

x

Tipo: int

A coordenada x na qual desenhar dentro do contexto do dispositivo especificado.

y

Tipo: int

A coordenada y na qual desenhar dentro do contexto do dispositivo especificado.

dx

Tipo: int

A largura da parte da imagem a ser desenhada em relação ao canto superior esquerdo da imagem. Se dx e dy forem zero, a função desenhará toda a imagem. A função não garante que os parâmetros sejam válidos.

dy

Tipo: int

A altura da parte da imagem a ser desenhada, em relação ao canto superior esquerdo da imagem. Se dx e dy forem zero, a função desenhará toda a imagem. A função não garante que os parâmetros sejam válidos.

rgbBk

Tipo: COLORREF

A cor da tela de fundo da imagem. Esse parâmetro pode ser um valor RGB definido pelo aplicativo ou um dos seguintes valores:

Valor	Significado
CLR_NONE	Sem cor da tela de fundo. A imagem é desenhada de forma transparente.
CLR_DEFAULT	A cor da tela de fundo padrão. A imagem é desenhada usando a cor da tela de fundo da lista de imagens.

rgbFg

Tipo: COLORREF

A cor de primeiro plano da imagem. Esse parâmetro pode ser um valor RGB definido pelo aplicativo ou um dos seguintes valores:

Valor	Significado
CLR_NONE	Sem mistura de cores. A imagem é misturada com a cor do contexto do dispositivo de destino.
CLR_DEFAULT	A cor de primeiro plano padrão. A imagem é desenhada usando a cor de realce do sistema como a cor de primeiro plano.

fStyle

Tipo: UINT

O estilo de desenho e, opcionalmente, a imagem de sobreposição. Para obter informações sobre como especificar um índice de imagem de sobreposição, consulte a seção comentários no final deste tópico. Esse parâmetro pode ser uma combinação de um índice de imagem de sobreposição e um ou mais dos seguintes valores:

Valor	Significado
ILD_BLEND
ILD_BLEND25	Desenha a imagem, combinando 25% com a cor de combinação especificada por rgbFg. Esse valor não terá efeito se a lista de imagens não contiver uma máscara.
ILD_BLEND50	Desenha a imagem, mesclando 50% com a cor de combinação especificada por rgbFg. Esse valor não terá efeito se a lista de imagens não contiver uma máscara.
ILD_FOCUS
ILD_IMAGE	Defina esse sinalizador se a sobreposição não exigir que uma máscara seja desenhada. Esse sinalizador faz com que ImageList_DrawEx desenhe apenas a imagem, ignorando a máscara.
ILD_MASK	Desenha a máscara.
ILD_NORMAL	Desenha a imagem usando a cor da tela de fundo da lista de imagens. Se a cor da tela de fundo for o valor CLR_NONE, a imagem será desenhada de forma transparente usando a máscara.
ILD_SELECTED
ILD_TRANSPARENT	Desenha a imagem de forma transparente usando a máscara, independentemente da cor da tela de fundo. Esse valor não terá efeito se a lista de imagens não contiver uma máscara.

Valor retornado

Tipo: BOOL

Retorna diferente de zero se tiver êxito; caso contrário, zero.

Comentários

Uma imagem de sobreposição é desenhada de forma transparente sobre a imagem primária especificada no parâmetro i . Para especificar uma imagem de sobreposição no parâmetro fStyle , use a macro INDEXTOOVERLAYMASK para deslocar o índice baseado em um da imagem de sobreposição. Use o operador OR para combinar logicamente o valor retornado da macro com os sinalizadores de estilo de desenho especificados no parâmetro fStyle . Primeiro, você deve especificar essa imagem como uma imagem de sobreposição usando a função ImageList_SetOverlayImage .

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	commctrl.h
Biblioteca	Comctl32.lib
DLL	Comctl32.dll