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 函数可与 SetDCPenColor 和 SetDCBrushColor 函数互换使用。

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

示例

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

要求

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

另请参阅

COLORREF

设备上下文函数

设备上下文概述

GetDCPenColor