ExtractIcon

Funkcia ExtractIcon načíta rukoväť na ikonu z zadaný spustiteľný súbor, knižnica (DLL) alebo súbor ikony.

Získavať zprovoznit popisovače veľké alebo malé ikony na funkciu ExtractIconEx.

(HICON ExtractIcon HINSTANCE  hInst; / / stupňa rukoväťLPCTSTRlpszExeFileName; / / názov súboru s ikonouUINTnIconIndex / / indexom ikony na extrahovanie);
 

Parametre

hInst

Zvládnuť stupňa uplatňovaní volá funkciu.

lpszExeFileName

Smerník na reťazec zakončený nulou určujúci názov spustiteľného súboru, DLL alebo ikonu súboru.

nIconIndex

Určuje zero-based index ikonu na načítanie. Napríklad, ak je táto hodnota 0, funkcia vráti rukoväť na prvú ikonu zadaný súbor.

Ak táto hodnota je –1, funkcia vráti celkový počet ikon v zadaného súboru. Ak súbor je spustiteľný súbor alebo DLL, vrátená hodnota je počet RT_GROUP_ICON zdrojov. Ak sa súbor nachádza.ICO súbor, vrátená hodnota je 1.

Systém Windows 95, Windows NT 4.0 a novšej: Ak je hodnota nerovná sa -1 záporné číslo, funkcia vráti rukoväť na ikonu v zadaný súbor, ktorého zdrojový identifikátor je rovnajúca sa absolútnej hodnote nIconIndex. Ak chcete extrahovať ikony, ktorého zdrojový identifikátor je 3 použiť napríklad -3. Ak chcete extrahovať ikony, ktorého zdrojový identifikátor je 1, použite funkciu ExtractIconEx.

Note:

Vrátená hodnota je rukoväť na ikonu. Ak súbor zadaný nebola spustiteľný súbor, DLL alebo súbor ikony, návratu je 1. Ak sa v súbore neboli nájdené žiadne ikony, vrátená hodnota je NULL.

Poznámky

Musíte zničiť ikonu rukoväť odoslal ExtractIcon volaním funkcie DestroyIcon.

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verzia 3.1 alebo novšia.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Nepodporované.
Hlavičky:Deklarovaný v shellapi.h.
Importovať knižnica:Použiť shell32.lib.
Unicode:Implementovaný ako Unicode, ANSI verzia v systéme Windows NT.

Pozri tiež

Ikony prehľad ikonu funkcie, DestroyIcon, ExtractIconEx

Index