### 函数功能

该函数把当前设备上下文环境（DC）画笔颜色设置为指定颜色值。如果设备不能提供指定的颜色值，那么就把颜色设为最近的物理颜色。

### 函数原型

COLORREF SetDCBrushColor(HDC hdc, COLORREF crColor)；

### 参数

hdc：设备上下文环境句柄。
crColor：指定新的画笔颜色。

### 返回值

如果成功，返回值指定先前设备上下文环境画笔颜色为COLORREF值；如果失败，返回CLR_INVALID。
注释：当在 一个设备上下文环境中选择系统备用DC_BRUSH时，所有的以后绘制操作将使用设备上下文环境画笔颜色，直到系统备用画笔被取消选择为止，缺省DC_BRUSH颜色是WHITE。
该函数将返回先前的DC_BRUSH颜色，即使在DC中没有选择系统备用画笔DC_BRUSH，但是，除非系统备用DC-BRUSH被选择，否则绘制操作将不使用它，设置颜色可参照设置笔和画笔颜色的例子。
使用DC_BRUSH或DC_PEN参数的GetStockObject函数可以与SetDCPenColor和SetDCBrushColor函数互换。
ICM：如果ICM可用就执行颜色管理。

### 速查

Windows NT：5.0及以上版本；Windows：不支持；Windows CE：不支持；头文件：wingdi.h；库文件：gdi32.lib。