createPatternBrush 函数 (wingdi.h)

CreatePatternBrush 函数使用指定的位图模式创建逻辑画笔。 位图可以是由 CreateDIBSection 函数创建的 DIB 节位图,也可以是依赖于设备的位图。

语法

HBRUSH CreatePatternBrush(
  [in] HBITMAP hbm
);

参数

[in] hbm

要用于创建逻辑画笔的位图的句柄。

返回值

如果函数成功,则返回值标识逻辑画笔。

如果函数失败,则返回值为 NULL。

注解

图案画笔是系统用于绘制填充形状内部的位图。

应用程序通过调用 CreatePatternBrush 创建画笔后,可以通过调用 SelectObject 函数在任何设备上下文中选择该画笔。

可以使用 DeleteObject 函数删除图案画笔,而不会影响关联的位图。 因此,可以使用此位图创建任意数量的图案画笔。

使用单色 (每像素 1 位) 位图创建的画笔具有绘制到的设备上下文的文本和背景色。 用当前文本颜色绘制由 0 位表示的像素;用当前背景色绘制由 1 位表示的像素。

Icm: 创建画笔时不执行任何颜色。 但是,当画笔被选入启用了 ICM 的设备上下文时,将执行颜色管理。

示例

有关示例,请参阅 使用画笔

要求

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

另请参阅

画笔函数

画笔概述

CreateBitmap

CreateBitmapIndirect

CreateCompatibleBitmap

CreateDIBPatternBrush

CreateDIBPatternBrushPt

CreateDIBSection

CreateHatchBrush

DeleteObject

GetBrushOrgEx

LoadBitmap

SelectObject

SetBrushOrgEx