ExtractIcon

Funkcja ExtractIcon pobiera dojścia do ikony z określonego pliku wykonywalnego, biblioteki dołączanej dynamicznie (DLL) lub pliku ikony.

Aby pobrać tablicę dojść do dużych lub małych ikon, należy użyć funkcji ExtractIconEx.

(HICON ExtractIcon Wystąpienie HINSTANCE  hInst, / / instancji uchwytLPCTSTRlpszExeFileName, / / nazwa pliku z ikonąUINTnIconIndex / / indeks z ikonę, aby wyodrębnić);
 

Parametry

hInst

Dojście do wystąpienia aplikacji wywołanie funkcji.

lpszExeFileName

Wskaźnik ciąg zakończony zerem, określający nazwę pliku wykonywalnego, biblioteka DLL lub pliku ikony.

nIconIndex

Określa indeks od zera tę ikonę, aby pobrać. Na przykład jeśli ta wartość jest równa 0, funkcja zwraca uchwyt na pierwszą ikonę z określonego pliku.

Jeśli wartość ta jest –1, 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ą, nie równa -1, funkcja zwraca uchwyt na ikonę w określonym pliku, którego 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. Aby wyodrębnić ikony, których identyfikator zasobu wynosi 1, należy użyć funkcji ExtractIconEx.

Zwraca wartości

Wartość zwracany jest dojściem do ikony. Jeśli określonego pliku nie został plik wykonywalny, biblioteka DLL lub ikonę pliku, zwrot jest równy 1. Jeśli ikony nie znaleziono w pliku, wartość zwracana jest wartość NULL.

Uwagi

Należy zniszczyć uchwyt ikony, zwrócony przez ExtractIcon przez wywołanie funkcji DestroyIcon.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
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, ExtractIconEx

Index