SetBkColor

小甲鱼

函数功能：

SetBkColor 函数用于设置当前的背景颜色。

如果指定的颜色值超出了当前设备的表示范围，则设置为最近似的、设备可以表示的颜色。


API 函数原型：

注释：_In_ 说明该参数是输入的。

COLORREF SetBkColor(
  _In_  HDC hdc,
  _In_  COLORREF crColor
);

参数解析：

参数	含义
hdc	指定设备环境句柄
crColor	新的背景颜色值（使用 RGB 宏获得 COLORREF 类型）

返回值：

1. 如果函数调用成功，返回值是先前背景的颜色值（COLORREF 类型）；

2. 如果函数调用失败，返回值是 CLR_INVALID。


备注：

1. 该函数填充由 CreatePen 函数创建出来的非实线画笔之间的空隙（例如点线画笔，填充的是画笔间点和线的空隙，不是客户区的背景颜色哦）。

2. 该函数不会填充由 ExtCreatePen 函数创建出来的画笔。

3. 该函数也可以用于填充 TextOut 函数和 ExtTextOut 函数输出字符的背景颜色。

4. 如果背景颜色设置为不透明（OPAQUE）时，背景颜色用来填充非实线画笔风格的间隙、阴影画刷和字符的背景颜色。

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。