Função ImageList_Draw (commctrl.h)
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 |
|---|---|
|
|
|
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. |
|
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. |
|
|
|
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. |
|
Desenha a máscara. |
|
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. |
|
|
|
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) |