SetDCPenColor

SetDCPenColor函数将当前设备上下文（DC）笔颜色设置为指定的颜色值。 如果设备无法表示指定的颜色值，则颜色将设置为最近的物理颜色。

COLORREF SetDCPenColor(  
    HDC hdc,          // 设备上下文句柄
    COLORREF crColor  // 新画笔颜色
);

参数

• hdc

• [in] 设备上下文句柄。

• crColor

• [in] 指定新的画笔颜色。

返回值

如果函数成功，则返回值将前一个DC笔颜色指定为COLORREF值。 如果函数失败，返回值为CLR_INVALID。

备注

该功能返回先前的DC_PEN颜色，即使DC中没有选择笔迹DC_PEN; 然而，直到在DC中选择了库存DC_PEN时，这不会用于绘图操作。

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

ICM：如果启用ICM，则执行颜色管理。

示例代码

有关设置颜色的示例，请参阅设置笔或画笔颜色。

要求

   Windows NT/2000/XP：包含在Windows NT 3.1及更高版本中。

   Windows 95/98/Me：包含在Windows 95及更高版本中。

   头文件：声明于Wingdi.h; 包含于Windows.h。

   库：使用Gdi32.lib。