ExtractIcon

De ExtractIcon functie haalt een handvat om een pictogram van het opgegeven uitvoerbare bestand, dynamic-link library (DLL) of pictogrambestand.

Gebruik de functie ExtractIconEx om een matrix van ingangen naar grote of kleine pictogrammen halen,.

HICON ExtractIcon) HINSTANCE  hInst, / / aanleg handvatLPCTSTRlpszExeFileName, / / bestandsnaam van het bestand met het pictogramUINTnIconIndex / / index van pictogram uitpakken);
 

Parameters

hInst
Ingang naar instantie van de toepassing aanroepen van de functie.
lpszExeFileName
Pointer naar een op null eindigende tekenreeks die de naam aangeeft van een uitvoerbaar bestand, DLL of pictogrambestand.
nIconIndex
Hiermee geeft u de op nul gebaseerde index van het pictogram op te halen. Bijvoorbeeld, als deze waarde 0 is, retourneert de functie een greep het eerste pictogram in het opgegeven bestand.

Als deze waarde –1 is, 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 niet gelijk aan -1 is, retourneert de functie een handvat naar het pictogram in het opgegeven bestand waarvan resource identifier gelijk aan de absolute waarde van nIconIndex is. Bijvoorbeeld, gebruik -3 het pictogram waarvan resource identifier 3 is uitpakken. Om het pictogram waarvan resource identifier 1 is, gebruikt u de functie ExtractIconEx.

Retourwaarden

De retourwaarde is een ingang tot een pictogram. Als het opgegeven bestand niet een uitvoerbaar bestand, DLL of het pictogrambestand was, is de terugkeer 1. Als er geen pictogrammen zijn gevonden in het bestand, is de retourwaarde NULL.

Opmerkingen

U moet vernietigen het pictogram handvat geretourneerd door ExtractIcon door de DestroyIcon functie.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Niet-ondersteunde.
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, ExtractIconEx

Index