ExtractIconEx

ExtractIconEx -funksjonen oppretter en matrise med referanser til store eller små ikoner som er trukket ut fra den angitte kjørbare filen, dynamiske koblingsbiblioteket (DLL) eller ikonfilen.

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

Parametere

lpszFile
Pekeren til en null-terminert streng som angir navnet på en kjørbar fil, DLL eller ikonfil som skal pakkes ut ikoner fra som.
nIconIndex
Angir nullbasert indeksen for det første ikonet til å trekke ut. For eksempel, hvis denne verdien er null, funksjonen trekker ut det første ikonet i angitt fil.

Hvis denne verdien er-1, og phIconLarge og phiconSmall er både NULL, returnerer funksjonen antall ikoner i angitt fil. Hvis filen er en kjørbar fil eller en DLL, er verdien som returneres antall RT_GROUP_ICON ressurser. Hvis filen er en.ICO-filen, returverdien er 1.

Windows 95, Windows NT 4.0 og senere: Hvis denne verdien er et negativt tall, og enten phIconLarge eller phiconSmall er ikke NULL, begynner funksjonen ved å trekke ut ikonet ressursidentifikatoren som er lik den absolutte verdien av nIconIndex. Bruk for eksempel -3 til å trekke ut ikonet som har ressursidentifikatoren er 3.

phiconLarge
Pekeren til en rekke ikonet håndtak som mottar referanser til de store ikonene som er trukket ut fra filen. Hvis denne parameteren er NULL, ingen store ikoner er trukket ut fra filen.
phiconSmall
Pekeren til en rekke ikonet håndtak som mottar referanser til små ikoner trukket ut fra filen. Hvis denne parameteren er NULL, ingen små ikoner er trukket ut fra filen.
nIcons
Angir hvor mange ikoner for å trekke ut fra filen.

Returverdier

Hvis parameteren nIconIndex er -1, phiconLarge -parameteren er NULL, og phiconSmall -parameteren er NULL, er verdien som returneres antall ikoner i den angitte filen. Ellers er returverdien hvor mange ikoner som er pakket ut fra filen.

Merknader

Du må ødelegge alle ikoner som er trukket ut av ExtractIconEx ved å kalle DestroyIcon -funksjonen.

Hvis du vil hente dimensjonene av store og små ikonene, bruker den GetSystemMetrics -funksjonen med SM_CXICON, SM_CYICON, SM_CXSMICON og SM_CYSMICON-flagg.

Windows CE: Parameteren nIconIndex må være null eller –N der n er et angitte ressurs-IDen. Parameteren nIcons må være 1.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.5 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i shellapi.h.
Importere biblioteket:Bruk shell32.lib.
Unicode:Implementert som Unicode- og ANSI-versjoner på Windows NT.

Se også

Oversikt over ikoner, ikonet funksjoner, DestroyIcon, ExtractIcon

Index