SetDCPenColor

小甲鱼

函数功能：

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

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


API 函数原型：

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

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

参数解析：

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

返回值：

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

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


备注：

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

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

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