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