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 |