PatBlt()函数

函数功能:该函数使用当前选入指定设备环境中的刷子绘制给定的矩形区域。通过使用给出的光栅操作来对该刷子的颜色和表面颜色进行组合。

参数:

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。