<Return[S]><Top>

SetDCPenColor

Declare Function Api_SetDCPenColor& Lib "gdi32" Alias "SetDCPenColor" (ByVal hDC&, ByVal colorref&)

Declare Function SetDCPenColor Lib "gdi32" Alias "SetDCPenColor" (ByVal hdc As Long, ByVal colorref As Long) As Long

現在のデバイスコンテキスト(DC)のペンの色を指定された色値に設定する。指定された色値をデバイスで表示できない場合は、物理的に最も近い色に設定される。

パラメータ
hdc
    デバイスコンテキスト(DC)のハンドルを指定する。
crColor
    新しいペンの色を指定する。

戻り値
    関数が成功すると、前回 DC で指定したペンの色に対する色参照が返る。
    関数が失敗すると、CLR_INVALID が返る。

解説
    この関数は、DC でストックペン DC_PEN が選択されていない場合でも、前回の DC_PEN の色を返す。ただし、DC でストック DC_PEN

    が選択されるまで、描画操作で前回の DC_PEN の色が使われることはない。
    GetStockObject 関数で引数 DC_BRUSH または DC_PEN を指定すると、SetDCPenColor 関数や SetDCBrushColor 関数と同じ結果

    が得られる。