Funzione LoadIconW (winuser.h)

Articolo
11/20/2024

Carica la risorsa icona specificata dal file eseguibile (.exe) associato a un'istanza dell'applicazione.

Nota

Questa funzione è stata sostituita dalla funzione LoadImage (con flag LR_DEFAULTSIZE e LR_SHARED impostati).

Sintassi

HICON LoadIconW(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCWSTR   lpIconName
);

Parametri

[in, optional] hInstance

Tipo: HINSTANCE

Handle per il modulo di un file DLL o eseguibile (.exe) che contiene l'icona da caricare. Per altre informazioni, vedere GetModuleHandle.

Per caricare un'icona di sistema predefinita, impostare questo parametro su NULL.

[in] lpIconName

Tipo: LPCTSTR

Se hInstance non èNULL, lpIconName specifica la risorsa icona in base al nome o all'ordinale. Questo ordinale deve essere creato in un pacchetto utilizzando la macro MAKEINTRESOURCE.

Se hInstance è NULL, lpIconName specifica l'identificatore (a partire dal prefisso IDI_) di un'icona di sistema predefinita da caricare.

Valore restituito

Tipo: hicon

Se la funzione ha esito positivo, il valore restituito è un handle per l'icona appena caricata.

Se la funzione ha esito negativo, il valore restituito è NULL. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

LoadIcon carica la risorsa icona solo se non è stata caricata; in caso contrario, recupera un handle per la risorsa esistente. La funzione cerca nella risorsa icona l'icona più appropriata per la visualizzazione corrente. La risorsa icona può essere un colore o una bitmap monocromatica.

loadIcon può caricare solo un'icona le cui dimensioni sono conformi ai valori delle metriche di sistema SM_CXICON e SM_CYICON. Usare la funzione LoadImage per caricare le icone di altre dimensioni.

Nota

L'intestazione winuser.h definisce LoadIcon 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 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
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)