DrawIconEx

A função de DrawIconEx desenha um ícone ou cursor na área de cliente da janela de contexto de dispositivo especificado, executando as operações de varredura especificado e esticando ou compactando o ícone ou cursor conforme especificado.

 (BOOL DrawIconEx HDC  hdc, / / identificador de contexto de dispositivo deintxLeft, / / x-coordenar do canto superior esquerdointyTop, / / y-coordenar do canto superior esquerdoHICONhIcon, / / identificador para o ícone para desenhar intcxWidth, / / largura do ícone intcyWidth, / / altura do íconeUINTistepIfAniCur, / / índice do quadro na animação cursorHBRUSHhbrFlickerFreeDraw, / / identificador para o pincel de plano de fundo UINTdiFlags / / ícone-desenho sinalizadores);
 

Parâmetros

hdc

Identificador para o contexto dispositivo para uma janela.

xLeft

Especifica o x lógica-coordenar do upper-left corner do ícone ou cursor.

yTop

Especifica a y lógica-coordenar da upper-left corner do ícone ou cursor.

hIcon

Identificador para o ícone ou cursor a ser desenhado. Este parâmetro pode identificar um cursor animado. O recurso de ícone ou cursor deve anteriormente carregado usando o LoadImage função.

cxWidth

Especifica a largura lógica do ícone ou cursor. Se este parâmetro é zero e o parâmetro de diFlags é DI_DEFAULTSIZE, a função usa o valor métrico sistema SM_CXICON ou SM_CXCURSOR para definir a largura. Se este parâmetro é zero e DI_DEFAULTSIZE não é usado, a função usa a largura de recurso real.

cyWidth

Especifica a altura lógica do ícone ou cursor. Se este parâmetro é zero e o parâmetro de diFlags é DI_DEFAULTSIZE, a função usa o valor métrico sistema SM_CYICON ou SM_CYCURSOR para definir a largura. Se este parâmetro é zero e DI_DEFAULTSIZE não é usado, a função usa a altura de recurso real.

istepIfAniCur

Especifica o índice do quadro para desenhar, se hIcon identifica um cursor animado. Este parâmetro é ignorado se hIcon não identifica um cursor animado.

hbrFlickerFreeDraw

Identificador para um pincel que o sistema usa para desenho de cintilação. Se hbrFlickerFreeDraw for um válido identificador pincel, o sistema cria um bitmap fora da tela usando o pincel especificado para a cor de fundo, desenha o ícone ou cursor em bitmap e, em seguida, copia o bitmap para o contexto de dispositivo identificado pelo hdc. Se hbrFlickerFreeDraw for NULL, o sistema desenha o ícone ou cursor diretamente no contexto de dispositivo.

diFlags

Especifica os sinalizadores de desenho. Este parâmetro pode ser uma dos seguinte valores:

Valor	Significado
DI_COMPAT	Desenha o ícone ou cursor usando a imagem padrão do sistema, em vez da imagem especificada pelo usuário.
DI_DEFAULTSIZE	Desenha o ícone ou cursor usando a largura e altura especificada pelos valores métricos sistema de cursores ou ícones, se os parâmetros cxWidth e cyWidth são definidos como zero. Se este sinalizador não for especificado e cxWidth e cyWidth são definidas como zero, a função usa o tamanho de recurso real.
DI_IMAGE	Desenha o ícone ou cursor usando a imagem.
DI_MASK	Desenha o ícone ou cursor usando a máscara.
DI_NORMAL	Combinação de DI_IMAGE e DI_MASK.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é diferente de zero.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

A DrawIconEx função coloca upper-left corner do ícone no local especificado pelo xLeft e yTop parâmetros. O local está sujeito a atual modo de mapeamento do contexto do dispositivo.

Windows CE: As seguintes configurações de parâmetro devem ser usadas

• diFlags deve ser DI_NORMAL, DI_IMAGE ou DI_MASK. (DI_COMPAT e DI_DEFAULTSIZE não são suportados.)
• cxWidth e cyHeight devem ser zero ou as dimensões nativas do ícone.
• hbrFlickerFreeDraw deve ser NULL.
• iStepIfAniCur deve ser zero. Não há suporte para ícones animados.

Windows CE não oferece suporte:

• Alongamento e compressão.

  Ou seja, a resolução de ícone é fixada para um determinado HICON, e nenhum ícone redimensionamento é suportado.

• Modos de mapeamento.
• Usando DrawIconEx para desenhar cursores.

O parâmetro hIcon não pode identificar um cursor animado.

QuickInfo

nbsp; Windows &NT: requer a versão 3.5 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de ícones, ícone funções, CopyImage, DrawIcon, LoadImage

Index