Função GetIconInfoExW (winuser.h)

Artigo
11/20/2024

Recupera informações sobre o ícone ou cursor especificado. GetIconInfoEx estende GetIconInfo usando a estrutura de ICONINFOEX mais recente.

Sintaxe

BOOL GetIconInfoExW(
  [in]      HICON        hicon,
  [in, out] PICONINFOEXW 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 de começando com o prefixo IDI_ ou o identificador de começando com o prefixo IDC_ nesse parâmetro.

[in, out] piconinfo

Tipo: PICONINFOEX

Quando esse método é retornado, contém um ponteiro para uma estrutura de ICONINFOEX . A função preenche os membros da estrutura.

Valor de retorno

Tipo: BOOL

verdadeiro indica êxito, FALSE indica falha.

Observações

GetIconInfoEx cria bitmaps para o hbmMask e hbmColor ou membros doICONINFOEX. O aplicativo de chamada deve gerenciar esses bitmaps e excluí-los com DeleteObject chamada 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.

Nota

O cabeçalho winuser.h define GetIconInfoEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winuser.h (inclua Windows.h)
biblioteca	User32.lib
de DLL	User32.dll

Consulte também

Conceitual

bitmaps

Ícones

DeleteObject

GetObject

BITMAP

CreateIcon

CreateIconFromResource

CreateIconIndirect

DestroyIcon

DrawIcon

DrawIconEx

loadicon

LookupIconIdFromDirectory

ICONINFO

Compartilhar via