SetDCBrushColor 関数 (wingdi.h)

SetDCBrushColor 関数は、現在のデバイスコンテキスト (DC) ブラシの色を指定した色の値に設定します。デバイスが指定された色の値を表すことができない場合、色は最も近い物理色に設定されます。

構文

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

[in] hdc

DC へのハンドル。

[in] color

新しいブラシの色。

関数が成功した場合、戻り値は前の DC ブラシの色を COLORREF 値として指定します。

関数が失敗した場合、戻り値は CLR_INVALID です。

DC でストック DC_BRUSHを選択すると、ストックブラシの選択が解除されるまで、後続のすべての図面は DC ブラシの色を使用して実行されます。既定のDC_BRUSHの色は WHITE です。

この関数は、DC でストックブラシDC_BRUSHが選択されていない場合でも、前のDC_BRUSHの色を返します。ただし、DC でストック DC_BRUSHが選択されるまで、これは描画操作では使用されません。

DC_BRUSHまたはDC_PENの引数を持つ GetStockObject 関数は、SetDCPenColor 関数および SetDCBrushColor 関数と同じ意味で使用できます。

Icm： ICM が有効になっている場合、カラー管理が実行されます。

色を設定する例については、「ペンまたはブラシの色を設定する」を参照してください。

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