ExtractIcon

ExtractIcon işlevi belirtilen yürütülebilir dosya, dinamik bağlantı kitaplığı (dll) veya simge dosyası tutamacı simge durumuna alır.

Tanıtıcıları büyük veya küçük simgeleri bir dizi almak için ExtractIconEx işlevini kullanın.

HICON ExtractIcon) HINSTANCE  hInst, / / örnek tanıtıcılpctstrlpszExeFileName, / / simgesi olan dosyanın adıUINTnIconIndex / / Dizin ayıklama simgesi);
 

Parametreleri

hInst

İşlevi çağıran uygulamanın örneğini ele.

lpszExeFileName

Bir çalıştırılabilir dosya, dll veya simge dosyasının adını belirten bir boş sonlandırılmış dize işaretçisi.

nIconIndex

Simge almak için sıfır tabanlı dizin belirtir. Bu değer 0 ise, örneğin, bir kolu belirtilen dosya ilk simgesinin işlevi.

Bu değer –1 ise, işlev belirtilen dosyada simgeleri toplam sayısını döndürür. Dosya bir çalıştırılabilir dosya veya dll ise, dönüş değeri RT_GROUP_ICON kaynakları sayısıdır. Dosyanın olup olmadığını bir.ICO dosya, dönüş değeri 1'dir.

Windows 95, Windows NT 4.0 ve daha sonraki: Bu değer, negatif bir sayı -1 değerine eşit değil ise, işlev nIconIndexmutlak değerine eşit olan tanıtıcısı belirtilen dosya simgesinin bir tanıtıcısı döner. Örneğin, -3 3 olan kaynak tanımlayıcısıdır simgesi ayıklamak için kullanın. Simgesi olan kaynak tanımlayıcısı 1 olur ayıklamak için ExtractIconEx işlevini kullanın.

Dönüş değerleri

Dönüş değeri bir tanıtıcı bir simge değil. Belirtilen dosya bir yürütülebilir dosya, dll veya simge dosyası yoksa, 1 gelirdir. Dosyada hiçbir simge bulunamadı, dönüş değeri null olur.

Açıklamalar

DestroyIcon işlevini çağırarak ExtractIcon tarafından döndürülen simgesi tutamacını imha etmeniz gerekir.

QuickInfo

nbsp; Windows &NT: sürüm 3.1 veya üstü gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Desteklenmeyen.
Header:Shellapi.h içinde ilan etti.
İçe Library:Shell32.lib kullanın.
Unicode:Unicode ve ANSI sürümleri Windows NT olarak uygulanır.

Ayrıca bkz:

Simgeleri genel bakış, simgesini fonksiyonlar, DestroyIcon, ExtractIconEx

Index