SetDCBrushColor

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

SetDCBrushColor hdc, color

hdc : [intptr] DC へのハンドル。
color : [int] 新しいブラシの色。

(プラグイン / モジュール : gdi32.dll)

解説

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

[戻り値]
関数が成功した場合、戻り値は以前の DC ブラシ色を COLORREF 値として指定する。関数が失敗した場合、戻り値は
CLR_INVALID である。

[備考]
ストック DC_BRUSH が DC に選択されている場合、ストックブラシが選択解除されるまで、以降のすべての描画は DC
ブラシの色を使用して行われる。デフォルトの DC_BRUSH の色は白である。関数は、ストックブラシ DC_BRUSH が DC
に選択されていなくても、以前の DC_BRUSH の色を返す。ただし、これはストック DC_BRUSH が DC
に選択されるまで描画操作で使用されない。DC_BRUSH または DC_PEN を引数とする GetStockObject
関数は、SetDCPenColor および SetDCBrushColor 関数と相互に置き換えて使用できる。ICM: ICM
が有効な場合、カラー管理が実行される。

情報