patBlt 函数 (wingdi.h)

PatBlt 函数使用当前在指定设备上下文中选择的画笔绘制指定的矩形。画笔颜色和表面颜色或颜色通过使用指定的光栅操作进行组合。

语法

BOOL PatBlt(
  [in] HDC   hdc,
  [in] int   x,
  [in] int   y,
  [in] int   w,
  [in] int   h,
  [in] DWORD rop
);

[in] hdc

设备上下文的句柄。

[in] x

要填充的矩形左上角的 x 坐标（以逻辑单位为单位）。

[in] y

要填充的矩形左上角的 y 坐标（以逻辑单位为单位）。

[in] w

矩形的宽度（以逻辑单位为单位）。

[in] h

矩形的高度（以逻辑单位为单位）。

[in] rop

光栅操作代码。此代码可以是以下值之一。

值	含义
PATCOPY	将指定的模式复制到目标位图中。
PATINVERT	使用布尔 XOR 运算符将指定图案的颜色与目标矩形的颜色组合在一起。
DSTINVERT	反转目标矩形。
黑暗	使用与物理调色板中的索引 0 关联的颜色填充目标矩形。（对于默认的物理调色板，该颜色为黑色。）
白	使用与物理调色板中的索引 1 关联的颜色填充目标矩形。（对于默认的物理调色板，该颜色为白色。）

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。

此函数的 dwRop 参数的值是完整 256 个三元光栅操作代码的有限子集;具体而言，不能使用引用源矩形的操作代码。

并非所有设备都支持 PatBlt 函数。有关详细信息，请参阅 GetDeviceCaps 函数中RC_BITBLT功能的说明。

有关示例，请参阅使用菜单中的“Menu-Item 位图示例”。


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll