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