CDC::PlgBlt

BOOL PlgBlt(POINT lpPoint ,CDC* pSrcDC,int xSrc ,int ySrc , intnWidth ,int nHeight, CBitmap& maskBitmap,int xMask ,int yMask);

返回值:如果成功,则返回非零值,否则为0。

参数:
lpPoint逻辑空间中包含三个点的数组的指针。它指定了一个目标平行四边形的三个顶点。源矩形的左上角与数组中的第一个点映射,右上角与第二个点映射,第三个点指向左下角。源矩形的右下角与平行四边形未能明确表示的第四点映射。
pSrcDC源设备上下文的标识。
xSrc用逻辑单位表示的源矩形左上角的X坐标。
ySrc用逻辑单位表示的源矩形左上角的Y坐标。
nWidth用逻辑单位表示的源矩形的宽度。
nHeight用逻辑单位表示的源矩形的高度。
maskBitmap标识用以屏蔽源矩形颜色的可选的黑白位图。
xMask黑白位图左上角的X坐标。
yMask黑白位图左上角的Y坐标。

说明:
对源设备上下文指定的矩形到给定设备上下文中平行四边形的颜色数据实行位块(bit-block)转换。如果位掩码的句柄代表一个有效的位图,函数利用该函数对源矩形的颜色数据位进行屏蔽。平行四边形的第四个顶点(D)是将前三个点(A,B,C)定义为矢量后,经D=B+C-A计算得到。如果存在位掩码1,表示源像素色将会拷贝给目标位图,为0表示目标位图的像素不会被改变。如果掩码矩形小于源矩形和目标矩形,函数将复制掩码模式。在源设备上下文中允许度量形式转换和解释。但不允许选择和剪切转换,掩码位图不是黑白位图,出错。目标设备上下文的扩展模式决定了像素如何被扩展或压缩。如果源设备上下文标识了增强元文件设备上下文,记录增强元文件时,则出错。依据目标设备上下文转换目标坐标,依据源设备上下文转换源坐标。如果源转换中有选择或剪切操作,则返回错误。如果目标和源矩形的颜色格式不一致, PlgBlt将转换源矩形使其与目标矩形匹配。不是所有设备都支持PlgBlt。要了解更多的信息,请参阅CDC::GetDeviceCaps 成员函数中RC_BITBLT光栅能力的描述。如果源设备上下文和目标设备上下文代表的设备不兼容,PlgBlt返回错误。

请参阅:
CDC::BitBlt, CDC::GetDeviceCaps, CDC::MaskBlt, CDC::StretchBlt, ::Set StretchBltMode, ::PlgBlt