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