LoadIcon

La funzione LoadIcon carica la risorsa icona specificato dall'eseguibile (.File EXE) associato a un'istanza di applicazione. Questa funzione è stata sostituita dalla funzione LoadImage

(HICON LoadIcon HINSTANCE , hInstance, / / handle all'istanza dell'applicazioneLPCTSTRlpIconName / / nome icona risorse di stringa o icona / / identificatore);
 

Parametri

hInstance

Gestire a un'istanza del modulo cui file eseguibile contiene l'icona deve essere caricato. Questo parametro deve essere NULL quando viene caricato un icona standard.

lpIconName

Puntatore a una stringa null-terminated che contiene il nome della risorsa icona deve essere caricato. In alternativa, questo parametro può contenere l'identificatore di risorsa nella parola significativi e zero nella parola significativi. Utilizzare la macro MAKEINTRESOURCE per creare questo valore.

Per utilizzare una delle icone predefinite, impostare il parametro hInstance su NULL e il parametro lpIconName per uno dei seguenti valori:

Valore	Descrizione
IDI_APPLICATION	Sull'icona dell'applicazione predefinita.
IDI_ASTERISK	Come IDI_INFORMATION.
IDI_ERROR	Icona a forma di mano.
IDI_EXCLAMATION	Come IDI_WARNING.
IDI_HAND	Come IDI_ERROR.
IDI_INFORMATION	Icona asterisco.
IDI_QUESTION	Icona del punto interrogativo.
IDI_WARNING	Icona del punto esclamativo.
IDI_WINLOGO	Icona di Windows logo.

Valori restituiti

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

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

Osservazioni

LoadIcon carica la risorsa icona solo se non è stato caricato; in caso contrario, recupera un handle alla risorsa esistente. La funzione cerca la risorsa icona per l'icona più appropriata per la visualizzazione corrente. La risorsa icona può essere una bitmap a colori o in bianco e nero.

LoadIcon possibile caricare solo un'icona la cui dimensione è conforme ai valori di metrici di sistema SM_CXICON e SM_CYICON. Utilizzare la funzione LoadImage per caricare icone di altre dimensioni.

Windows CE: Icone predefinite (IDI_ *) non sono supportati.

In Windows CE 1.0, l'icona deve essere un po' due a icona pixel (.ic2) o da un'icona monocromatica.

Vedi anche

Panoramica di icone, funzioni di icona, CreateIcon, LoadImage, MAKEINTRESOURCE

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index