ExtractIconEx

La funzione ExtractIconEx crea una matrice di maniglie di icone grandi o piccole, estratte dal file eseguibile specificato, libreria a collegamento dinamico (DLL) o file icona.

(UINT ExtractIconEx LPCTSTR  lpszFile, int  nIconIndex, Molto HICON  * phiconLarge, Molto HICON  * phiconSmall, UINT  nIcons);
 

Parametri

lpszFile
Puntatore a una stringa con terminazione null specificando il nome di un file eseguibile, DLL o file di icona da cui saranno estratte icone.
nIconIndex
Specifica l'indice in base zero dell'icona prima di estrarre. Ad esempio, se questo valore zero, la funzione estrae la prima icona nel file specificato.

Se questo valore 1 e phIconLarge e phiconSmall sono entrambi NULL, 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 e phIconLarge o phiconSmall non NULL, la funzione inizia estraendo l'icona cui identificatore di risorsa uguale al valore assoluto del nIconIndex. Ad esempio, utilizzare -3 per estrarre l'icona cui identificatore di risorsa 3.

phiconLarge
Puntatore a una matrice di maniglie icona che riceve le maniglie alle icone grandi estratte dal file. Se questo parametro NULL, non le grandi icone sono estratte dal file.
phiconSmall
Puntatore a una matrice di maniglie icona che riceve le maniglie alle piccole icone estratte dal file. Se questo parametro NULL, non le piccole icone sono estratte dal file.
nIcons
Specifica il numero di icone per estrarre dal file.

Valori restituiti

Se il parametro nIconIndex -1, il parametro phiconLarge NULL e il parametro phiconSmall NULL, il valore restituito il numero di icone contenute nel file specificato. In caso contrario, il valore restituito il numero delle icone con successo estratto dal file.

Osservazioni

Devono distruggere tutte le icone estratte da ExtractIconEx chiamando la funzione DestroyIcon.

Per recuperare le dimensioni delle icone grandi e piccole, utilizzare il funzione GetSystemMetrics con i flag SM_CXICON, SM_CYICON, SM_CXSMICON e SM_CYSMICON.

Windows CE: Il parametro nIconIndex deve essere zero o n dove n un identificatore di risorsa specificata. Il parametro nIcons deve essere 1.

Descrizione

nbsp;Windows &NT: richiede una versione 3.5 o successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
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, ExtractIcon

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

Index