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