CDC::MaskBlt

Makale
02/26/2013

Belirtilen maske ve Tarama işlemi kullanarak kaynak ve hedef bitmapler için renk verilerini bir araya getirir.

BOOL MaskBlt(
   int x,
   int y,
   int nWidth,
   int nHeight,
   CDC* pSrcDC,
   int xSrc,
   int ySrc,
   CBitmap& maskBitmap,
   int xMask,
   int yMask,
   DWORD dwRop 
);

Parametreler

x
Mantıksal x-koordinatı hedef dikdörtgeninin sol üst köşesini belirler.
y
Mantıksal y-koordinatı hedef dikdörtgeninin sol üst köşesini belirler.
nWidth
Hedef dikdörtgen ve kaynak bitmap mantıksal birimler cinsinden genişliğini belirtir.
nHeight
Hedef dikdörtgen ve kaynak bitmap mantıksal birimler cinsinden yüksekliğini belirtir.
pSrcDC
Bit eşlem kopyalanacak olduğu aygıt içeriğini tanımlar.Sıfır olmalıdır dwRop parametresi, bir kaynağı içermeyen bir raster işlemi belirtir.
xSrc
Kaynak bitmap sol üst köşesinin mantıksal x-koordinatı belirtir.
ySrc
Kaynak bitmap sol üst köşesinin mantıksal y-koordinatı belirtir.
maskBitmap
Kaynak aygıt bağlamında renkli bit eşlem ile birleştirilmiş tek renkli maskesini bitmap tanımlar.
xMask
Belirtilen maske bitmap yatay piksel uzaklık belirtir maskBitmap parametresi.
yMask
Belirtilen maske bitmap için dikey piksel uzaklığını belirtir maskBitmap parametresi.
dwRop
Ön plan ve arka plan Üçlü tarama işlemi kaynak ve hedef veri birleşimi denetlemek için işlevini kullanır kodlarını belirtir.Arka plan raster operasyon kodu bu değer üst sınırı yüksek bayttaki saklanır; Bu değer üst sınırı düşük bayttaki ön tarama işlemi kodu depolanır; Bu değerin düşük word gözardı edilir ve sıfır olmalıdır.Makro MAKEROP4 ön ve arka plan gibi birleşimlerini raster işlem kodlarını oluşturur.Ön plan ve arka plan işlevi bu bağlamda, bir tartışma için açıklamalar bölümüne bakın.Bkz: BitBlt üye işlevi ortak raster işlem kodlarının listesi için.

Dönüş Değeri

Sıfır olmayan bir değer işlevi başarılı olursa; Aksi halde 0.

Notlar

Bir değeri tarafından belirtilen maske 1 maskBitmap tarafından belirtilen ön tarama işlemi kodu gösterir dwRop o konumda uygulanmalıdır.Arka plan raster işlem kodu ile belirtilen Maskede 0 değeri gösterir dwRop o konumda uygulanmalıdır.Raster işlemleri bir kaynağı gerektiriyorsa, maske dikdörtgen kaynak dikdörtgen kapsamalıdır.Yoksa, işlev başarısız olur.Raster işlemleri bir kaynak gerek duymuyorsanız, maske dikdörtgen hedef dikdörtgen kapsamalıdır.Yoksa, işlev başarısız olur.

Bu işlev çağrıldığında, döndürme veya Yamultma dönüşümü için kaynak aygıt içeriği etkinse, bir hata oluşur.Ancak, diğer tür dönüştürmeleri izin verilir.

Kaynak, desen ve hedef bit eşlemler renk biçimlerini farklıysa, bu işlev desen veya kaynak biçimi ya da her ikisini de hedef biçimiyle eşleşecek şekilde dönüştürür.Tek renkli bitmap maskesi bitmap değilse bir hata oluşur.Bir Gelişmiş Meta dosyası kaydedildiği sırada bir hata oluştuğunda (ve işlevi 0 değerini döndürür), geliştirilmiş meta dosyası aygıt içeriğini kaynak aygıt içeriğini tanımlar.Destekleyen tüm aygıtları MaskBlt.Bir uygulama çağırmalıdır GetDeviceCaps bir aygıtı bu işlevi destekleyip desteklemediğini belirlemek için.Hiçbir maskesini bitmap belirttiğinizde, bu işlevi tam olarak gibi davranan BitBlt, ön tarama işlemi kodu kullanarak.Piksel (0,0) noktası maskesini bitmap eşlenecek kaynak aygıt içeriğin bit eşlem kaydırır.Bu maske bitmap maskeleri kümesini içeren durumlarda kullanışlıdır; bir uygulamayı kolayca bunlardan herhangi birinin maske birleştiriliyor göreve piksel uzaklık ayarlayarak uygulayabilirsiniz ve dikdörtgen boyutlarında gönderilen MaskBlt.