函数功能:该函数把当前设备上下文环境(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。