SetDCBrushColor 函数 (wingdi.h)

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

语法

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

参数

[in] hdc

DC 的句柄。

[in] color

新的画笔颜色。

返回值

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

如果函数失败,则返回值为 CLR_INVALID。

注解

在 DC 中选择库存DC_BRUSH时,将使用 DC 画笔颜色完成所有后续绘图,直到取消选择股票画笔。 默认DC_BRUSH颜色为白色。

该函数返回以前的DC_BRUSH颜色,即使未在 DC 中选择股票画笔DC_BRUSH:但是,在 DC 中选择股票DC_BRUSH之前,不会在绘图操作中使用。

参数为 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

设备上下文函数

设备上下文概述

GetDCBrushColor