勇芳软件工作室.汉化:  Painting and Drawing > Painting and Drawing Functions >

SetBkColor

Previous pageReturn to chapter overviewNext page

描述

 

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

 

C++ 语法

 

COLORREF SetBkColor(

__in HDC hdc,

__in COLORREF crColor

);

 

PowerBASIC 语法

 

FUNCTION SetBkColor ( _

BYVAL hdc AS DWORD, _

BYVAL crColor AS DWORD _

) AS DWORD

 

参数

 

hdc

 

[in]处理设备上下文。

 

crColor

 

[in]指定新的背景颜色。要使COLORREF值,请使用RGB宏。

 

返回值

 

如果函数成功,则返回值将前一个背景颜色指定为COLORREF值。

 

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

 

备注

 

此函数填充使用由CreatePen函数创建的笔绘制的样式线之间的间距;它不填充使用由ExtCreatePen函数创建的笔绘制的样式线之间的间隙。SetBKColor功能还设置了TextOutExtTextOut的背景颜色。

 

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

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)