createSolidBrush 函数 (wingdi.h)

CreateSolidBrush 函数创建具有指定纯色的逻辑画笔。

语法

HBRUSH CreateSolidBrush(
  [in] COLORREF color
);

参数

[in] color

画笔的颜色。 若要创建 COLORREF 颜色值,请使用 RGB 宏。

返回值

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

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

注解

如果不再需要 HBRUSH 对象,请调用 DeleteObject 函数将其删除。

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

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

若要使用系统颜色画笔进行绘制,应用程序应使用 GetSysColorBrush (nIndex) 而不是 CreateSolidBrush(GetSysColor(nIndex)),因为 GetSysColorBrush 返回缓存的画笔,而不是分配新的画笔。

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

示例

有关示例,请参阅 创建彩色笔和画笔

要求

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

另请参阅

画笔函数

画笔概述

COLORREF

CreateDIBPatternBrush

CreateDIBPatternBrushPt

CreateHatchBrush

CreatePatternBrush

DeleteObject

GetSysColorBrush

RGB

SelectObject