Funzione GetIconInfoExA (winuser.h)

Articolo
03/13/2024

Recupera informazioni sull'icona o sul cursore specificati. GetIconInfoEx estende GetIconInfo usando la struttura ICONINFOEX più recente.

Sintassi

BOOL GetIconInfoExA(
  [in]      HICON        hicon,
  [in, out] PICONINFOEXA 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 a partire dal prefisso IDI_ o dall'identificatore a partire dal prefisso IDC_ in questo parametro.

[in, out] piconinfo

Tipo: PICONINFOEX

Quando questo metodo restituisce, contiene un puntatore a una struttura ICONINFOEX . La funzione riempie i membri della struttura.

Valore restituito

Tipo: BOOL

TRUE indica l'esito positivo, FALSE indica l'errore.

Commenti

GetIconInfoEx crea bitmap per i membri hbmMask e hbmColor o ICONINFOEX. 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 dalla DPI del thread chiamante.

Nota

L'intestazione winuser.h definisce GetIconInfoEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll