平台 SDK: Windows GDI

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函数可以与SetDCPenColorSetDCBrushColor函数互换使用。

ICM:如果启用ICM,则执行颜色管理。

示例代码


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

要求

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

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

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

   库:使用Gdi32.lib。