CDC::PlgBlt

项目
03/01/2013

在源设备上下文执行位的位阻塞调用颜色数据从指定的矩形到指定的平行四边形在特定设备上下文。

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

参数

lpPoint
在标识目标平行四边形的三个角的逻辑空间指向数组三点。源矩形的左上角该数组映射到第一个点，对于第二的右上角该数组点，并且，对于第三的左下角点。源矩形的右下角在该平行四边形映射到隐式第四个点。
pSrcDC
标识源设备上下文。
xSrc
在逻辑单位指定该x坐标，源矩形的左上角。
ySrc
在逻辑单位指定该y坐标，源矩形的左上角。
nWidth
在逻辑单位指定宽度，源矩形。
nHeight
在逻辑单位指定该高度，源矩形。
maskBitmap
标识用于掩码源矩形的颜色的可选单色位图。
xMask
指定单色位图的左上角的x坐标。
yMask
指定单色位图的左上角的y坐标。

返回值

非零，如果函数运行成功;否则为0。

备注

如果给定位掩码处理标识有效的单色位图，该函数使用此位图位掩码从源矩形的颜色数据。

平行四边形(d)的第四个顶点是通过将前三点定义(A，B和C)作为矢量图像和计算D = B + C - A。

如果该位掩码存在，值为1在掩码指示应复制源像素颜色为目标。值0在掩码指示不会更改目标像素颜色。

如果掩码矩形比源和目标矩形，该功能复制掩模模式。

缩放、转换和反射将源设备上下文允许;但是，在旋转和平移是。如果掩码位图不是一个纯色位图，错误。如果有必要，目标设备上下文的拉伸模式如何在紧挨着拉伸或压缩像素。当一个增强型图元文件中记录时，将会出错，如果源设备上下文标识引发图元文件设备上下文。

目标坐标根据目标设备上下文转换;源坐标是由设备上下文进行转换。如果源将具有旋转或)，则会返回错误。如果目标和源矩形没有相同颜色的格式，PlgBlt 转换源矩形与目标矩形。并非所有设备的支持 PlgBlt。有关更多信息，请参见 RC_BITBLT 光栅功能的说明。CDC::GetDeviceCaps 成员函数。

如果源页和目标设备上下文表示不兼容的计算机，PlgBlt 返回false。