Função DrawIcon (winuser.h)
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) |
Confira também
Conceitual
Referência