共用方式為


SetBkColor 函式 (wingdi.h)

SetBkColor函式會將目前的背景色彩設定為指定的色彩值,如果裝置無法代表指定的色彩值,則設定為最接近的實體色彩。

語法

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

參數

[in] hdc

裝置內容的控制碼。

[in] color

新的背景色彩。 若要建立 COLORREF 值,請使用 RGB 宏。

傳回值

如果函式成功,傳回值會將先前的背景色彩指定為 COLORREF 值。

如果函式失敗,則傳回值是 CLR_INVALID。

備註

此函式會填滿使用 CreatePen 函式所建立的手寫筆繪製的樣式線條之間的間距;它不會填滿使用 ExtCreatePen 函式所建立的畫筆繪製的樣式線條之間的間距。 SetBkColor函式也會設定TextOutExtTextOut的背景色彩。

如果背景模式為 OPAQUE,背景色彩會用來填滿樣式線條之間的間距、筆刷中影線之間的間距,以及字元儲存格。 將點陣圖從色彩轉換成單色時,也會使用背景色彩,反之亦然。

範例

For an example, see "Example of Owner-Drawn Menu Items" in Using Menus.

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 wingdi.h (包含 Windows.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

COLORREF

CreatePen

ExtCreatePen

GetBKColor

GetBkMode

繪製和繪製函式

繪製和繪圖概觀

SetBkMode