Função ImageList_Draw (commctrl.h)

  • Artigo

Desenha um item da lista de imagens no contexto do dispositivo especificado.

Sintaxe

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

Parâmetros

himl

Tipo: HIMAGELIST

Um identificador para a lista de imagens.

i

Tipo: int

O índice baseado em zero 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.

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 realce do sistema. Esse valor não terá efeito se a lista de imagens não contiver uma máscara.
ILD_BLEND50
 Desenha a imagem, combinando 50% com a cor de realce do sistema. 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
Conjunto de APIs ext-ms-win-shell-comctl32-init-l1-1-1 (introduzido no Windows 10, versão 10.0.14393)