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