ExtractIconEx

De ExtractIconEx functie maakt een matrix van ingangen naar grote of kleine pictogrammen geëxtraheerd uit het opgegeven uitvoerbare bestand, dynamic-link library (DLL) of pictogrambestand.

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

Parameters

lpszFile

Pointer naar een op null eindigende tekenreeks die de naam aangeeft van een uitvoerbaar bestand, DLL of pictogrambestand waaruit pictogrammen worden uitgepakt.

nIconIndex

Hiermee geeft u de op nul gebaseerde index van het eerste pictogram om uit te pakken. Bijvoorbeeld, als deze waarde nul is, haalt de functie het eerste pictogram in het opgegeven bestand.

Als deze waarde –1 en phIconLarge en phiconSmall beide NULL zijn, retourneert de functie het aantal pictogrammen in het opgegeven bestand. Als het bestand een uitvoerbaar bestand of een dll-bestand is, is de geretourneerde waarde het aantal RT_GROUP_ICON resources. Als het bestand is een.ICO bestand, de geretourneerde waarde is 1.

Windows 95, Windows NT 4.0, en later: Als deze waarde een negatief getal is en ofwel phIconLarge of phiconSmall niet NULL is, begint de functie met het uitpakken van het pictogram waarvan resource identifier gelijk aan de absolute waarde van nIconIndex is. Gebruik bijvoorbeeld -3 om te pakken het pictogram waarvan resource identifier 3 is.

phiconLarge

Aanwijzer naar een matrix van pictogram grepen die ingangen naar de grote pictogrammen uit het bestand uitgepakt ontvangt. Als deze parameter NULL is, worden geen grote pictogrammen geëxtraheerd uit het bestand.

phiconSmall

Aanwijzer naar een matrix van pictogram grepen die ingangen naar de kleine pictogrammen uit het bestand uitgepakt ontvangt. Als deze parameter NULL is, worden geen kleine pictogrammen geëxtraheerd uit het bestand.

nIcons

Hiermee geeft u het aantal pictogrammen te extraheren uit het bestand.

Retourwaarden

Als de parameter nIconIndex -1 is, de phiconLarge -parameter NULL is, en de parameter phiconSmall NULL is, dan is de geretourneerde waarde het aantal pictogrammen in het opgegeven bestand opgenomen. De retourwaarde is anders, het aantal pictogrammen met succes uitgepakt uit het bestand.

Opmerkingen

U moet vernietigen alle pictogrammen geëxtraheerd door ExtractIconEx door de DestroyIcon functie.

De afmetingen van de grote en kleine pictogrammen ophalen, gebruiken de GetSystemMetrics functie met de SM_CXICON, SM_CYICON, SM_CXSMICON en SM_CYSMICON flags.

Windows CE: De parameter nIconIndex moet nul of –N waarbij n staat voor een opgegeven resource identifier. De parameter nIcons moet 1.

Syntaxisinfo

nbsp; Windows &NT: versie 3.5 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
Header:Verklaard in shellapi.h.
Bibliotheek importeren:Gebruik shell32.lib.
Unicode:Geïmplementeerd als Unicode en ANSI-versies van Windows NT.

Zie ook

Pictogrammen overzicht, pictogram functies, DestroyIcon, ExtractIcon

Index