ExtractIcon

Funksjonen ExtractIcon henter et håndtak til et ikon fra den angitte kjørbare filen, dynamiske koblingsbiblioteket (DLL) eller ikonfilen.

Hvis du vil hente en rekke referanser til store eller små ikoner, bruk ExtractIconEx -funksjonen.

() HICON ExtractIcon HINSTANCE  hInst, / / eksempel håndtakLPCTSTRlpszExeFileName, / / filnavnet for filen med ikonetUINTnIconIndex / / indeks av ikonet for å trekke ut);
 

Parametere

hInst
Håndtere til forekomst av programmet kalle funksjonen.
lpszExeFileName
Pekeren til en null-terminert streng som angir navnet på en kjørbar fil, DLL eller ikonfilen.
nIconIndex
Angir nullbasert indeks for ikonet Hvis du vil hente. Hvis denne verdien er 0, returnerer for eksempel funksjonen et håndtak til det første ikonet i angitt fil.

Hvis denne verdien er-1, 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 er ikke lik -1, returnerer funksjonen en referanse til ikonet i den angitte filen som inneholder ressursidentifikatoren som er lik den absolutte verdien av nIconIndex. For eksempel kan du bruke -3 til å trekke ut ikonet som har ressursidentifikatoren er 3. Hvis du vil pakke ut ikonet med ressurs-ID er 1, bruk ExtractIconEx -funksjonen.

Returverdier

Returverdien er en referanse til et ikon. Hvis den angitte filen ikke var en kjørbar fil, DLL eller ikonfilen, er avkastningen 1. Hvis ingen ikoner ble funnet i filen, er returverdien NULL.

Merknader

Du må ødelegge det ikonet-håndtaket som returneres av ExtractIcon ved å kalle DestroyIcon -funksjonen.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
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, ExtractIconEx

Index