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

Confira também

Conceitual

CreateIcon

DrawIconEx

Ícones

Loadicon

Referência