Funzione LoadIconA (winuser.h)

Articolo
08/27/2023

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

Nota

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

Sintassi

HICON LoadIconA(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCSTR    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 è diverso da 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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

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 la cui dimensione è conforme ai valori delle metriche di sistema SM_CXICON e SM_CYICON . Usare la funzione LoadImage per caricare 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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)