CDC::MaskBlt

bool M&askBlt ( int x, int y, int nWidth, int nHeight, cdc * pSrcDC, int xSrc, int ySrc, CBitmapamp; maskBitmap, int xMask, int yMask, dword dwRop );

Dönüş değeri

İşlev başarılı olursa sıfırdan farklı; Aksi halde 0.

Parametreleri

x

Mantıksal x koordinatı hedef dikdörtgeninin sol üst köşesini belirtir.

y

Mantıksal y-koordinatı hedef dikdörtgeninin sol üst köşesini belirtir.

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

Bitmap kopyalanacak olduğu aygıt içeriğini tanımlar. DwRop parametresi bir tarama işlemi kaynağı içermeyen belirtirse sıfır olmalıdır.

xSrc

Mantıksal x-kaynak bitmap sol üst köşesinin koordinatını belirtir.

ySrc

Mantıksal y-kaynak bitmap sol üst köşesinin koordinatını belirtir.

maskBitmap

Renkli bitmap kaynak cihaz bağlamında ile birlikte tek renkli maskesini bitmap tanımlar.

xMask

MaskBitmap parametresi tarafından belirtilen maskesini bitmap yatay piksel uzaklığını belirtir.

yMask

MaskBitmap parametresi tarafından belirtilen maskesini bitmap dikey piksel uzaklığını belirtir.

dwRop

Hem ön plan hem de arka Üç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ğeri yüksek word yüksek bayt saklanır; ön tarama işlemi kodu yüksek kelime-in bu değer düşük bayt depolanır; Bu değer düşük kelime sayılır ve sıfır olmalıdır. Makro MAKEROP4 , raster işlem kodları için ön plan ve arka plan gibi kombinasyonları oluşturur. Ön plan ve arka plan bu işlev bağlamında bir tartışma için açıklamalar bölümüne bakın. BitBlt üye işlev genel tarama işlemi kodları listesi için bkz.

Açıklamalar

Belirtilen maske ve tarama işlemi kullanarak kaynak ve hedef bitmapler için renk verileri birleştirir. MaskBitmap tarafından belirtilen maske 1 değeri ön raster operasyon kod dwRop tarafından belirtilen konumda uygulanması gerektiğini gösterir. Maskede 0 değerini, arka plan raster operasyon kod dwRop tarafından belirtilen konumda uygulanması gerektiğini gösterir. Raster operasyonları kaynağı gerektiriyorsa, maske dikdörtgen kaynak dikdörtgen kapak gerekir. Yoksa, işlev başarısız olur. Raster işlemleri kaynak gerektirmeyen, maske dikdörtgen hedef dikdörtgen kapak gerekir. 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 geçerliyse, hata oluşur. Ancak, diğer tür dönüştürmeleri izin verilir.

Hedef bit eşlemler, desen ve kaynak renk biçimlerini farklıysa, bu işlev desen veya kaynak biçimi ya da her ikisi, hedef biçimiyle eşleşecek şekilde dönüştürür. Maskesini bitmap tek renkli bir bit eşlem ise, bir hata oluşur. Bir gelişmiş meta dosyası kaydedildiğinde bir hata oluşur (ve işlevi 0 değerini döndürür) Eğer bir gelişmiş meta dosyası aygıt içeriğini kaynak aygıt içeriğini tanımlar. Tüm aygıtlar MaskBltdesteklemez. Bir uygulama, bir aygıtı bu işlev destekleyip desteklemediğini belirlemek için GetDeviceCaps çağırmalısınız. Hiçbir maskesini bitmap belirttiğinizde, bu işlev ön tarama işlemi kodu kullanarak tam olarak BitBltgibi davranır. Piksel (0,0) noktası maskesini bitmap harita kaynak aygıt içeriği 's bitmap kaydırır. Bu maskesini bitmap maskeleri kümesini içeren durumlarda kullanışlıdır; Uygulama kolayca bunlardan herhangi birini bir maske-birleştiriliyor göreve piksel ofset ve MaskBlt için gönderilen dikdörtgenin boyutları ayarlayarak uygulayabilirsiniz.

cdc ge&nel bakış |nbsp; Sınıf üyeleri | Hiyerarşi çizelgesi

Ayrıca bkz:nbsp;CDC::BitBlt, CDC::GetDeviceCaps, CDC::PlgBlt, CDC::StretchBlt, :: MaskBlt

Index