通过

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

另请参阅

画笔函数

画笔概述

GetDeviceCaps