Função GetIconInfo (winuser.h)
Recupera informações sobre o ícone ou cursor especificado.
Sintaxe
BOOL GetIconInfo(
[in] HICON hIcon,
[out] PICONINFO piconinfo
);
Parâmetros
[in] hIcon
Tipo: HICON
Um identificador para o ícone ou cursor.
Para recuperar informações sobre um ícone ou cursor padrão, especifique o identificador começando com o prefixo IDI_ ou o identificador começando com o prefixo IDC_ nesse parâmetro.
[out] piconinfo
Tipo: PICONINFO
Um ponteiro para uma estrutura ICONINFO . A função preenche os membros da estrutura.
Retornar valor
Tipo: BOOL
Se a função for bem-sucedida, o valor retornado será diferente de zero e a função preencherá os membros da estrutura ICONINFO especificada.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
GetIconInfo cria bitmaps para hbmMask e hbmColor ou membros do ICONINFO. O aplicativo de chamada deve gerenciar esses bitmaps e excluí-los com a chamada DeleteObject quando eles não forem mais necessários.
Virtualização de DPI
Essa API não participa da virtualização de DPI. A saída retornada não é afetada pelo DPI do thread de chamada.Requisitos
| Requisito | Valor |
|---|---|
| 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-1-0 (introduzido em Windows 8) |
Confira também
Conceitual