Funzione GetIconInfoExA (winuser.h)

Articolo
11/20/2024

Recupera informazioni sull'icona o sul cursore specificati. GetIconInfoEx estende GetIconInfo usando la struttura di 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 che inizia con il prefisso IDI_ o l'identificatore che inizia con il prefisso IDC_ in questo parametro.

[in, out] piconinfo

Tipo: PICONINFOEX

Quando termina, questo metodo 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 un errore.

Osservazioni

GetIconInfoEx crea bitmap per hbmMask e hbmColor o membri di ICONINFOEX. L'applicazione chiamante deve gestire queste bitmap ed eliminarle con DeleteObject chiamare 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.

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)
libreria	User32.lib
dll	User32.dll