ExtractIcon

La funzione ExtractIcon recupera un handle ad un'icona dal file eseguibile specificato, libreria a collegamento dinamico (DLL) o file icona.

Per recuperare una matrice di punti d'aggancio da icone grandi o piccole, utilizzare la funzione ExtractIconEx.

(HICON ExtractIcon HINSTANCE  hInst, / / handle di istanzaLPCTSTRlpszExeFileName, / / nome del file del file con l'iconaUINTnIconIndex / / indice dell'icona per estrarre);
 

Parametri

hInst

Gestire all'istanza dell'applicazione chiamata della funzione.

lpszExeFileName

Puntatore a una stringa con terminazione null specificando il nome di un file eseguibile, DLL o file icona.

nIconIndex

Specifica l'indice in base zero dell'icona per recuperare. Ad esempio, se questo valore è 0, la funzione restituisce un handle per la prima icona nel file specificato.

Se questo valore è – 1, la funzione restituisce il numero totale delle icone nel file specificato. Se il file è un file eseguibile o DLL, il valore restituito è il numero di risorse RT_GROUP_ICON. Se il file è un.File ICO, il valore restituito è 1.

Windows 95, Windows NT 4.0 e successive: Se questo valore è un numero negativo non è uguale a -1, la funzione restituisce un handle all'icona nel file specificato cui identificatore di risorsa è uguale al valore assoluto del nIconIndex. Ad esempio, utilizzare -3 per estrarre l'icona cui identificatore di risorsa è 3. Per estrarre l'icona cui identificatore di risorsa è 1, utilizzare la funzione ExtractIconEx.

Valori restituiti

Il valore restituito è un handle per un'icona. Se il file specificato non è stato un file eseguibile, DLL o file icona, il ritorno è 1. Se non le icone sono state trovate nel file, il valore restituito è NULL.

Osservazioni

Deve distruggere l'handle icona restituito dalla ExtractIcon chiamando la funzione DestroyIcon.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in Shellapi.
Importare librerie:Utilizzare shell32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Panoramica di icone, funzioni di icona, DestroyIcon, ExtractIconEx

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

Index