SetDCPenColor 関数 (wingdi.h)
SetDCPenColor 関数は、現在のデバイス コンテキスト (DC) ペンの色を指定した色の値に設定します。 デバイスが指定した色の値を表すことができない場合、色は最も近い物理色に設定されます。
構文
COLORREF SetDCPenColor(
[in] HDC hdc,
[in] COLORREF color
);
パラメーター
[in] hdc
DC へのハンドル。
[in] color
新しいペンの色。
戻り値
関数が成功した場合、戻り値は前の DC ペンの色を COLORREF 値として指定します。 関数が失敗した場合、戻り値は CLR_INVALID です。
注釈
この関数は、DC でストック ペン DC_PENが選択されていない場合でも、前のDC_PEN色を返します。ただし、DC でストック DC_PENが選択されるまで、これは図面操作では使用されません。
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 |