setBkColor 函数 (wingdi.h)

SetBkColor 函数将当前背景色设置为指定的颜色值，如果设备无法表示指定的颜色值，则设置为最近的物理颜色。

语法

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

[in] hdc

设备上下文的句柄。

[in] color

新的背景色。若要创建 COLORREF 值，请使用 RGB 宏。

如果函数成功，则返回值将以前的背景色指定为 COLORREF 值。

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

此函数填充使用 CreatePen 函数创建的笔绘制的带样式的线条之间的间隙;它不会填充使用 ExtCreatePen 函数创建的笔绘制的带样式的线条之间的间隙。 SetBkColor 函数还设置 TextOut 和 ExtTextOut 的背景色。

如果背景模式为 OPAQUE，则背景色用于填充带样式的线条、画笔中阴影线和字符单元格之间的间隙。将位图从颜色转换为单色时，也会使用背景色，反之亦然。

有关示例，请参阅 Using Menu 中的“Owner-Drawn 菜单项示例”。


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