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 の場合、背景色を使用して、スタイル設定された線間のギャップ、ブラシ内のハッチングされた線間のギャップ、および文字セルを塗りつぶします。 背景色は、ビットマップをカラーからモノクロに、またはその逆に変換する場合にも使用されます。

例

例については、「メニューの 使用」の「メニュー項目の Owner-Drawn 例」を参照してください。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wingdi.h (Windows.h を含む)
Library Gdi32.lib
[DLL] Gdi32.dll

関連項目

COLORREF

Createpen

ExtCreatePen

GetBKColor

GetBkMode

描画関数と描画関数

描画と描画の概要

SetBkMode