Função GetIconInfo (winuser.h)

Artigo
03/04/2024

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)