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 |