CreateDIBPatternBrush 函数 (wingdi.h)

CreateDIBPatternBrush 函数创建一个逻辑画笔，该画笔具有指定的设备无关位图指定的模式 (DIB) 。画笔随后可以选择到与支持光栅操作的设备关联的任何设备上下文中。

注意此函数仅用于与 16 位版本的 Windows 兼容。应用程序应使用 CreateDIBPatternBrushPt 函数。

语法

HBRUSH CreateDIBPatternBrush(
  [in] HGLOBAL h,
  [in] UINT    iUsage
);

[in] h

包含打包 DIB 的全局内存对象的句柄，该对象由 BITMAPINFO 结构组成，后跟定义位图像素的字节数组。

[in] iUsage

指定是否初始化 BITMAPINFO 结构的 bmiColors 成员，如果初始化，则指定此成员是否包含显式的红色、绿色、蓝色 (RGB) 值或索引到逻辑调色板中。 fuColorSpec 参数必须是以下值之一。

值	含义
DIB_PAL_COLORS	提供了一个颜色表，它由一个 16 位索引数组组成，该数组位于要在其中选择画笔的设备上下文的逻辑调色板中。
DIB_RGB_COLORS	提供了一个颜色表，其中包含文本 RGB 值。

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

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

当应用程序在单色设备上下文中选择双色 DIB 图案画笔时，系统不会确认 DIB 中指定的颜色;而是使用设备上下文的当前背景和前景颜色显示图案画笔。映射到 DIB 颜色表中第一种颜色的像素 (偏移量 0，) 使用前景色显示;映射到颜色表中第二种颜色 (偏移量 1 的像素) 使用背景色显示。

如果不再需要画笔，请调用 DeleteObject 函数将其删除。

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

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