ExtractIconEx

Funcția ExtractIconEx creează o serie de mânerele pentru pictograme mari sau mici extrase din fișierul executabil specificat, biblioteca cu legare dinamică (DLL) sau Fișier pictogramă.

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

Parametrii

lpszFile
Indicatorul la un șir null-terminated care specifică numele unui fișier executabil, DLL sau Fișier pictogramă din care vor fi extrase icoane.
nIconIndex
Specifică indexul zero-based prima pictogramă de extras. De exemplu, dacă această valoare este zero, funcția extrase prima pictogramă în fișierul specificat.

Dacă această valoare este –1 și phIconLarge și phiconSmall sunt ambele NULL, 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 și fie phIconLarge sau phiconSmall nu este NULL, funcția începe prin extragerea pictograma ale căror 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.

phiconLarge
Indicatorul matrice de pictograma mânerele care prime?te mânere pentru pictograme mari extrase din fișier. Dacă acest parametru este NULL, nici un pictograme mari sunt extrase din fișier.
phiconSmall
Indicatorul matrice de pictograma mânerele care prime?te mânerele de la icoane mici extrase din fișier. Dacă acest parametru este NULL, nici un Pictograme mici sunt extrase din fișier.
nIcons
Specifică numărul de pictograme pentru a extrage din fișierul.

Valorile întroarse

Dacă parametrul nIconIndex este -1, parametrul phiconLarge este NULL și parametrul phiconSmall este NULL, apoi valoarea returnată este numărul de icoane conținute în fișierul specificat. În caz contrar, valoarea returnată este numărul de icoane cu succes extras din fișierul.

Observații

Tu trebuie să distrugă toate pictogramele extrase de ExtractIconEx sunând la funcția de DestroyIcon.

Pentru a prelua dimensiunile pictograme mari și mici, utilizați GetSystemMetrics funcție cu steagurile SM_CXICON, SM_CYICON, SM_CXSMICON și SM_CYSMICON.

Windows CE: Parametrul nIconIndex trebuie să fie zero sau –N unde n este un identificator de resurse specificată. Parametrul nIcons trebuie să fie 1.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.5 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
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, ExtractIcon

Index