setDCPenColor 函数 (wingdi.h)

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

语法

COLORREF SetDCPenColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

参数

[in] hdc

DC 的句柄。

[in] color

新笔颜色。

返回值

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

注解

该函数返回以前的DC_PEN颜色,即使未在 DC 中选择股票笔DC_PEN;但是,在 DC 中选择了常用DC_PEN之前,这不会用于绘图操作。

具有 DC_BRUSH 或 DC_PEN 参数的 GetStockObject 函数可与 SetDCPenColorSetDCBrushColor 函数互换使用。

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

示例

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

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

COLORREF

设备上下文函数

设备上下文概述

GetDCPenColor