描述
PatBlt函数使用当前选定到指定设备上下文中的画笔来绘制指定的矩形。通过使用指定的光栅操作来组合画笔颜色和表面颜色或颜色。
C++ 语法
BOOL PatBlt( __in HDC hdc, __in int nXLeft, __in int nYLeft, __in int nWidth, __in int nHeight, __in DWORD dwRop ); |
PowerBASIC 语法
FUNCTION PatBlt( _ hdc AS DWORD, _ nXLeft AS LONG, _ nYLeft AS LONG, _ nWidth AS LONG, _ nHeight AS LONG, _ dwRop AS DWORD _ ) AS LONG |
参数
hdc
[in]处理设备上下文。
nXLeft
[in]指定要填充的矩形左上角的x坐标（以逻辑为单位）。
nYLeft
[in]指定要填充的矩形左上角的y坐标（以逻辑为单位）。
nWidth
[in]指定矩形的逻辑单位宽度。
nHeight
[in]指定矩形的高度（以逻辑为单位）。
dwRop
[in]指定栅格操作代码。此代码可以是以下值之一。
值 |
含义 |
PATCOPY |
将指定的模式复制到目标位图中。 |
PATINVERT |
通过使用布尔XOR运算符将指定图案的颜色与目标矩形的颜色相结合。 |
DSTINVERT |
反转目的矩形。 |
BLACKNESS |
使用物理调色板中与索引0相关联的颜色填充目标矩形。（默认的物理色板为此颜色为黑色） |
WHITENESS |
使用物理调色板中与索引1相关联的颜色填充目标矩形。（该颜色对于默认的物理调色板为白色。） |
返回值
如果函数成功，返回值不为零。
如果函数失败，返回值为零。
Windows NT / 2000 / XP / Vista / Windows 7：要获取扩展错误信息，请调用GetLastError.
备注
该函数的dwRop参数的值是完整256个三进制光栅操作代码的有限子集;特别地，不能使用引用源矩形的操作代码。
并非所有设备都支持PatBlt功能。有关详细信息，请参阅GetDeviceCaps功能中的RC_BITBLT功能的说明。
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）