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.

Kaynak İşlev sürümü
Bit eşlem NesneSil
İmleç DestroyCursor
Simge DestroyIcon

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