Função DrawIcon (winuser.h)

Artigo
02/01/2024

Desenha um ícone ou cursor no contexto do dispositivo especificado.

Para especificar opções de desenho adicionais, use a função DrawIconEx .

Sintaxe

BOOL DrawIcon(
  [in] HDC   hDC,
  [in] int   X,
  [in] int   Y,
  [in] HICON hIcon
);

Parâmetros

[in] hDC

Tipo: HDC

Um identificador para o contexto do dispositivo no qual o ícone ou cursor será desenhado.

[in] X

Tipo: int

A coordenada x lógica do canto superior esquerdo do ícone.

[in] Y

Tipo: int

A coordenada y lógica do canto superior esquerdo do ícone.

[in] hIcon

Tipo: HICON

Um identificador para o ícone a ser desenhado.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

DrawIcon coloca o canto superior esquerdo do ícone no local especificado pelos parâmetros X e Y . O local está sujeito ao modo de mapeamento atual do contexto do dispositivo.

DrawIcon desenha o ícone ou cursor usando a largura e a altura especificadas pelos valores de métrica do sistema para ícones; para obter mais informações, consulte GetSystemMetrics.

A função DrawIcon chama DrawIconEx passando DI_NORMAL|DI_DEFAULTSIZE como sinalizadores.

Exemplos

Para obter um exemplo, consulte Exibindo um ícone.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-gui-l1-3-1 (introduzido no Windows 10, versão 10.0.14393)