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