LoadImage

LoadImage işlevi bir simge, imleç veya bit eşlem yükler.

Kolu LoadImage) HINSTANCE  hinst, / / örneği tutamacı içeren görüntülpctstrlpszName, / / adı veya resmin tanıtıcısıUINTuType, / / tip görüntüintcxDesired, / / istenen Genişlik intcyDesired, / / yükseklik istenenUINTfuLoad / / yük bayrakları);
 

Parametreleri

hinst

Yüklenecek görüntü içeren modül bir örneği için tanıtıcı. oem yansımayı yüklemek için bu parametreyi sıfır olarak ayarlayın.

lpszName

Yüklemek için görüntüyü işlemek.

Hinst parametresi null olmayan ve fuLoad parametresi LR_LOADFROMFILE içermeyen lpszName biten hinst modülünde görüntü kaynak adı içeren bir dize işaretçisi ise.

Hinst null ise ve LR_LOADFROMFILE belirtilmezse, bu parametrenin DSA'da sözcük yük oem resmin tanıtıcısı olmalıdır. oem görüntü tanımlayıcılar WINUSER tanımlanır.H ve varsa aşağıdaki ekler:

Önek	Anlamı
OBM_	Oem bitmapler
OIC_	Oem simgeleri
OCR_	Oem imleçler

FuLoad parametresi LR_LOADFROMFILE değeri içeriyorsa, lpszName görüntüyü içeren dosya adıdır.

uType

Yüklenecek görüntü türünü belirtir. Bu parametre aşağıdaki değerlerden biri olabilir:

Değer	Anlamı
IMAGE_BITMAP	Bit eşlem yükler.
IMAGE_CURSOR	Bir imleç yükler.
IMAGE_ICON	Simge yükler.

cxDesired

Simgeyi veya imleç piksel cinsinden genişliğini belirtir. Bu parametreyi sıfır ve fuLoad parametresi LR_DEFAULTSIZE genişliğini ayarlamak için SM_CXICON veya sm_cxcursor sistem Ölçü değerini işlevini kullanır. Bu parametre sıfırdır ve LR_DEFAULTSIZE kullanılan, gerçek kaynak genişliği işlevini kullanır.

cyDesired

Simgesini veya imleç piksel cinsinden yüksekliğini belirtir. Bu parametreyi sıfır ve fuLoad parametresi LR_DEFAULTSIZE yüksekliğini ayarlamak için SM_CYICON veya sm_cycursor sistem Ölçü değerini işlevini kullanır. Bu parametre sıfırdır ve LR_DEFAULTSIZE kullanılan, gerçek kaynak yüksekliği işlevini kullanır.

fuLoad

Aşağıdaki değerleri bir birleşimini belirtir:

Değer	Anlamı
LR_DEFAULTCOLOR	Varsayılan bayrağı; hiçbir şey yok. Tüm demek olduğunu "değil lr_monochrome".
LR_CREATEDIBSECTION	IMAGE_BITMAP uType parametresi belirtir, uyumlu bir bit eşlem yerine, DIB bölümü bitmap işlevinin neden olur. Bu bayrak, bir bitmap görüntü aygıtının renkleri eşleme olmadan yüklemek için yararlıdır.
LR_DEFAULTSIZE	CxDesired veya cyDesired değerleri sıfır olarak ayarlarsanız, genişliği veya yüksekliği imleçleri veya simgeler, sistem ölçüm değerleri belirtilen kullanır. Bu bayrak belirtilmezse ve cxDesired ve cyDesired sıfır olarak ayarlarsanız, gerçek kaynak boyut işlevi kullanır. Kaynak birden fazla resim varsa, ilk görüntünün boyutunu işlevini kullanır.
LR_LOADFROMFILE	LpszName parametresi tarafından belirtilen dosyadan resim yükler. Bu bayrak belirtilmezse, kaynak adı lpszName olur.
LR_LOADMAP3DCOLORS	Görüntünün renk tablosunu arar ve grinin aşağıdaki ilgili 3d rengiyle değiştirir:

	Renk	Yerine
	Dk Gray, RGB(128,128,128)	COLOR_3DSHADOW
	Gray, RGB(192,192,192)	COLOR_3DFACE
	Lt Gray, RGB(223,223,223)	COLOR_3DLIGHT

LR_LOADTRANSPARENT	İlk piksel görüntü renk değeri alır ve renk tablosunda karşılık gelen bir giriş varsayılan pencere rengini (COLOR_WINDOW) ile değiştirir. Tüm pikselleri görüntünün bu girdiyi kullanmaya varsayılan pencere rengi olur. Bu değere karşılık gelen renk tablolarını içeren görüntülere uygular. Lrloadtransparent, fuLoad lr_loadtransparent ve LR_LOADMAP3DCOLORS değerleri içeriyorsa, önceliklidir. Ancak, renk tablosu girdisi COLOR_WINDOW yerine COLOR_3DFACE ile değiştirilir.
LR_MONOCHROME	Siyah beyaz görüntü yükler.
LR_SHARED	Resmi birden çok kez yüklü ise görüntü işleyici paylaşır. lr_shared ayarlanmışsa, LoadImage ikinci bir çağrı aynı kaynak için görüntüyü yeniden yükleyin ve farklı bir tanıtıcı döndürür. Lr_shared standart boyutları, bu yüklemeden sonra değiştirebilir veya dosyadan yüklenen resimler için kullanmayın. Windows 95 ve Windows 98: İstenen kaynak adının ilk resmi işlevi istenen boyuta bakılmaksızın önbellek bulur.
LR_VGACOLOR	Gerçek vga renkleri kullanır.

Dönüş değerleri

İşlev başarılı olursa, yeni yüklenen görüntünün kolu dönüş değeri olduğunu.

İşlev başarısız olursa, dönüş değeri null olur. Genişletilmiş hata bilgilerini için GetLastError.

Açıklamalar

Bit eşlem, imleç veya simge işiniz bittiğinde aşağıdaki tabloda işlevlerinden birini çağırarak ilişkili belleği serbest bırakabilirsiniz.

Onları oluşturan işlemi sonlandırır sistem otomatik olarak bu kaynakları siler, ancak uygun işlevini çağırarak belleğine kaydeder ve işlemin çalışma kümesi boyutunu azaltır.

Windows ce: CxDesired ve cyDesired parametreleri IMAGE_BITMAP sıfır olmalıdır.

Windows ce, germe ve daraltma simgelerini desteklemiyor.

FuLoad parametresi (lr_defaultcolor ==) sıfır olmalıdır.

Fare imleçleri desteklemez bir platform hedefliyorsanız, cxDesired ve cyDesired parametreleri sm_cxcursor ve sm_cycursor değerleri belirtemezsiniz ve IMAGE_CURSOR uType parametresi için belirtilemez.

Fare imleçleri destekleyen bir platform hedefliyorsanız, sm_cxcursor ve sm_cycursor cxDesired ve cyDesired parametreleri ve IMAGE_CURSOR uType parametresinde belirttiğiniz.

QuickInfo

nbsp; Windows &NT: sürüm 4.0 veya daha yenisini gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Sürüm 1.0 veya daha ilerisini gerektirir.
Header:WINUSER.h ilan etti.
İçe Library:User32.lib kullanın.
Unicode:Unicode ve ANSI sürümleri Windows NT olarak uygulanır.

Ayrıca bkz:

Kaynaklarına genel bakış, kaynak fonksiyonları, CopyImage, GetSystemMetrics, LoadBitmap, LoadCursor, LoadIcon

Index