函数功能:该函数使用当前选入指定设备环境中的刷子绘制给定的矩形区域。通过使用给出的光栅操作来对该刷子的颜色和表面颜色进行组合。
1 |
BOOL PatBlt(HDC hdc, int nXLeft, int nYLeft, int nWidth, int nHeight, DWORD dwRop); |
参数:
hdc:设备环境句柄。
nXLeft:指定要填充的矩形左上角的X轴坐标,坐标按逻辑单位表示。
nYLeft:指定要填充的矩形左上角的Y轴坐标,坐标按逻辑单位表示。
nWidth:指定矩形的宽度,按逻辑单位表示宽度。
nHeight:指定矩形的高度,按逻辑单位表示高度。
dwRop:指定光栅操作码。该操作码可以取下列值,这些值的含义如下:
PATCOPY:将指定的模式拷贝到目标位图中。
PATINVERT:使用布尔OR(或)操作符将指定模式的颜色与目标矩形的颜色进行组合。
DSTINVERT:将目标矩形反向。
BLACKNESS:使用物理调色板中与索引0相关的颜色填充目标矩形。(对于缺省的物理调色板而言,该颜色为黑色)。
WHITENESS:使用物理调色板中与索引1有关的颜色来填充目标矩形。(对于缺省的物理调色板而言,该颜色为白色)。
返回值:如果函数执行成功,则返回值为非零;如果函数执行失败,则返回值为0。
Windows NT:若想获得更多错误信息,请调用GetLastError函数。
备注:该函数的参数dwRop取值限定为全部256个三元光栅操作有限子集。特别地,涉及源矩形的操作码不能使用。
并非所有设备都支持PalBlt函数。有关更多的信息,请参考函数GetDeviceCaps中有关RC_BITBLT特性的描述。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:1.0及以上版本;头文件:wingdi.h:库文件:gdi32.lib。