函数功能:
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 函数互换。




