ExtractIcon

Funcţia ExtractIcon preia un mâner ca o pictogramă din fişierul executabil specificat, biblioteca cu legare dinamică (DLL) sau Fişier pictogramă.

Pentru a prelua o matrice de mânerele pentru pictograme mari sau mici, utilizaţi funcţia ExtractIconEx.

(HICON ExtractIcon HINSTANCE  hInst, / / exemplu mânerLPCTSTRlpszExeFileName, / / nume de fişier cu pictogramaUINTnIconIndex / / index de pictogramă de extras);
 

Parametrii

hInst

Mâner instanţă de apel funcţia de aplicarea.

lpszExeFileName

Indicatorul la un şir null-terminated care specifică numele unui fişier executabil, DLL sau Fişier pictogramă.

nIconIndex

Specifică indexul zero-based pictograma pentru a prelua. De exemplu, dacă această valoare este 0, funcţia întoarce un mâner de pe pictograma prima în fişierul specificat.

Dacă această valoare este –1, funcţia întoarce numărul total de icoane în fişierul specificat. Dacă fişierul este un fişier executabil sau DLL, valoarea returnată este numărul de resurse RT_GROUP_ICON. Dacă fişierul este o.Fişier ICO, valoarea returnată este 1.

Windows 95, Windows NT 4.0, şi mai târziu: Dacă această valoare este un număr negativ nu este egal cu -1, funcţia întoarce un mâner pictograma din fişierul specificat al cărui identificatorul de resursă este egală cu valoarea absolută a nIconIndex. De exemplu, utilizaţi-3 pentru a extrage pictograma ale căror identificatorul de resursă este 3. Pentru a extrage pictograma ale căror identificatorul de resursă este 1, utilizaţi funcţia ExtractIconEx.

Valorile întroarse

Valoarea returnată este un mâner ca o pictogramă. Dacă fişierul specificat nu a fost un fişier executabil, DLL sau Fişier pictogramă, întoarcerea este 1. Dacă pictogramele nu au fost găsite în fişierul, valoarea returnată este NULL.

Observaţii

Tu trebuie să distrugă ghidajul pictograma întors de ExtractIcon sunând la funcţia de DestroyIcon.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Neacceptat.
Antet:A declarat în shellapi.h.
Import Biblioteca:Utilizarea shell32.lib.
Unicode:Pus în aplicare ca Unicode şi ANSI versiuni Windows NT.

A se vedea, de asemenea

Icoane prezentare generală, funcţii Icon, DestroyIcon, ExtractIconEx

Index