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，背景色彩會用來填滿樣式線條之間的間距、筆刷中影線之間的間距，以及字元儲存格。將點陣圖從色彩轉換成單色時，也會使用背景色彩，反之亦然。

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