Funzione GetIconInfo (winuser.h)

Articolo
09/03/2024

Recupera informazioni sull'icona o sul cursore specificati.

Sintassi

C++

BOOL GetIconInfo(
  [in]  HICON     hIcon,
  [out] PICONINFO piconinfo
);

Parametri

[in] hIcon

Tipo: HICON

Handle per l'icona o il cursore.

Per recuperare informazioni su un'icona o un cursore standard, specificare l'identificatore che inizia con il prefisso IDI_ o l'identificatore che inizia con il prefisso IDC_ in questo parametro.

[out] piconinfo

Tipo: PICONINFO

Puntatore a una struttura ICONINFO . La funzione compila i membri della struttura.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero e la funzione riempie i membri della struttura ICONINFO specificata.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

GetIconInfo crea bitmap per hbmMask e hbmColor o i membri di ICONINFO. L'applicazione chiamante deve gestire queste bitmap ed eliminarle con la chiamata DeleteObject quando non sono più necessarie.

Virtualizzazione DPI

Questa API non partecipa alla virtualizzazione DPI. L'output restituito non è interessato dal valore DPI del thread chiamante.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-gui-l1-1-0 (introdotto in Windows 8)