SetDCBrushColor

小甲鱼

函数功能：

SetDCBrushColor 函数用于设置指定设备环境中的画刷对象的颜色值。

如果设备不能提供指定的颜色值，那么就把颜色设置为最近的物理颜色。


API 函数原型：

注释：_In_ 说明该参数是输入的。

COLORREF SetDCBrushColor(
  _In_  HDC hdc,
  _In_  COLORREF crColor
);

参数解析：

参数	含义
hdc	指定设备环境句柄
crColor	指定新的画刷颜色

返回值：

1. 如果函数调用成功，返回值是指定设备环境先前的画刷颜色值（COLORREF 类型）；

2. 如果函数调用失败，返回值是 CLR_INVALID。


备注：

1. 当在一个设备环境中选择系统预设的 DC_BRUSH 时，以后所有的绘图操作将使用设备环境中的画刷颜色，直到系统预设的画刷被取消选择为止，默认的 DC_BRUSH 颜色是 WHITE。

2. 该函数将返回先前的 DC_BRUSH 颜色，即使在设备环境中没有选择系统预设的画刷 DC_BRUSH。然而，除非系统预设的 DC_BRUSH 被选择入设备环境，否则绘图操作将不使用它。

3. 使用 DC_PEN 或 DC_BRUSH 参数的 GetStockObject 函数可以与 SetDCPenColor 函数和 SetDCBrushColor 函数互换。

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。