ExtractIconEx

ExtractIconEx funkcia vytvorí pole popisovače veľké alebo malé ikony extrahovaný zo zadaný spustiteľný súbor, knižnica (DLL) alebo súbor ikony.

(UINT ExtractIconEx LPCTSTR  lpszFile; int  nIconIndex; HICON ĎALEKO  * phiconLarge; HICON ĎALEKO  * phiconSmall; UINT  nIcons);
 

Parametre

lpszFile
Smerník na reťazec zakončený nulou určujúci názov spustiteľného súboru, DLL alebo súbor ikony, z ktorých bude extrahovať ikony.
nIconIndex
Určuje zero-based index prvú ikonu extrahovať. Napríklad, ak táto hodnota nie je nulová, funkcia výťažky prvú ikonu zadaný súbor.

Ak táto hodnota je –1 a phIconLarge a phiconSmall sú obe NULL, funkcia vráti celkový počet ikon v zadaný súbor. 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 táto hodnota je záporné číslo a phIconLarge alebo phiconSmall nie je NULL, funkcia začína extrakciou ikony, 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.

phiconLarge
Ukazovateľ na pole ikonu kľučky, ktorý dostane popisovače veľké ikony extrahovaný zo súboru. Ak má tento parameter hodnotu NULL, žiadne veľké ikony sú extrahované zo súboru.
phiconSmall
Ukazovateľ na pole ikonu kľučky, ktorý dostane popisovače malé ikony extrahovaný zo súboru. Ak má tento parameter hodnotu NULL, malé ikony sú extrahované zo súboru.
nIcons
Určuje počet ikony extrahovať zo súboru.

Note:

Ak nIconIndex parameter je -1, phiconLarge parameter hodnotu NULL, a phiconSmall parameter má hodnotu NULL, vrátená hodnota je počet ikon obsiahnuté v zadaného súboru. V opačnom prípade vrátenej hodnoty je počet ikony úspešne extrahovaný zo súboru.

Poznámky

Musíte zničiť všetky ikony vylúhovaných ExtractIconEx volaním funkcie DestroyIcon.

Ak chcete získať rozmery veľké a malé ikony, použite GetSystemMetrics funkcie s SM_CXICON, SM_CYICON, SM_CXSMICON a SM_CYSMICON vlajky.

Windows CE: NIconIndex parameter musí byť nula alebo –N kde n je zadaný zdrojový identifikátor. NIcons parameter musí byť 1.

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verzia 3.5 alebo novšia verzia.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Vyžaduje verziu 1.0 alebo novšiu verziu.
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, ExtractIcon

Index