ExtractIconEx

Funkcja ExtractIconEx tworzy tablicę dojść do dużych lub małych ikon wydobyte z określonego pliku wykonywalnego, biblioteki dołączanej dynamicznie (DLL) lub pliku ikony.

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

Parametry

lpszFile

Wskaźnik ciąg zakończony zerem, określający nazwę pliku wykonywalnego, biblioteka DLL lub pliku ikony, z którego zostaną wyodrębnione ikony.

nIconIndex

Określa indeks od zera pierwszą ikonę, aby wyodrębnić. Na przykład jeśli ta wartość jest równa zero, funkcja wyodrębnia pierwszą ikonę z określonego pliku.

Jeśli ta wartość jest –1 i phIconLarge i phiconSmall są obie wartości NULL, funkcja zwraca całkowitą liczbę ikon w określonym pliku. Jeśli plik jest pliku wykonywalnego lub pliku DLL, wartość zwracany jest liczba zasobów, RT_GROUP_ICON. Jeśli plik jest.ICO pliku, wartość zwracany jest 1.

Systemu Windows 95, Windows NT 4.0 i nowszej: Jeśli ta wartość jest liczbą ujemną, phIconLarge lub phiconSmall nie ma wartości NULL, funkcja rozpoczyna się po wyodrębnieniu ikony, których identyfikator zasobu jest równa wartości bezwzględnej nIconIndex. Na przykład użyć -3, aby wyodrębnić ikony, których identyfikator zasobu jest 3.

phiconLarge

Wskaźnik do tablicy ikonę uchwyty, który odbiera dojścia do dużych ikon ekstrahowany z pliku. Jeśli ten parametr ma wartość NULL, nie duże ikony są ekstrahowane z pliku.

phiconSmall

Wskaźnik do tablicy ikonę uchwyty, który odbiera dojścia do małych ikon ekstrahowany z pliku. Jeśli ten parametr ma wartość NULL, nie małe ikony są ekstrahowane z pliku.

nIcons

Określa liczbę ikon do wyodrębniania z pliku.

Zwraca wartości

Jeżeli parametr nIconIndex jest równy -1, parametr phiconLarge ma wartość NULL, a parametr phiconSmall ma wartość NULL, wartość zwracany jest liczba ikon zawartych w określonym pliku. W przeciwnym razie wartość zwracany jest liczba ikon pomyślnie wyodrębnione z pliku.

Uwagi

Należy zniszczyć wszystkich ikon ekstrahowanych ExtractIconEx przez wywołanie funkcji DestroyIcon.

Aby pobrać rozmiary ikon dużych i małych, użyj GetSystemMetrics funkcji flagi SM_CXICON, SM_CYICON, SM_CXSMICON i SM_CYSMICON.

Systemu Windows CE: Parametr nIconIndex musi być zero lub –N gdzie n jest identyfikatorem określonego zasobu. Parametr nIcons musi być 1.

Skrócone informacje

nbsp; Windows &NT: wymaga wersji 3.5 lub nowszej.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w shellapi.h.
Importowanie biblioteki:Należy użyć shell32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Omówienie ikon, ikona funkcji, DestroyIcon, ExtractIcon

Index