CreatePen

指定されたスタイル、幅、色を持つ論理ペンを作成する。ペンは DC に選択して線や曲線の描画に使用できる。

CreatePen iStyle, cWidth, color

iStyle : [int] 
cWidth : [int] ペンの幅(論理単位)。0 の場合、現在の変換に関わらず 1 ピクセル幅。PS_DASH、PS_DOT、PS_DASHDOT、PS_DASHDOTDOT スタイルで 1 より大きい幅を指定した場合、CreatePen は PS_SOLID スタイルの指定幅ペンを返す。
color : [int] ペンの色への参照。COLORREF 構造体は RGB マクロで生成する。

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

解説

指定されたスタイル、幅、色を持つ論理ペンを作成する。ペンは DC に選択して線や曲線の描画に使用できる。

[戻り値]
関数が成功した場合、戻り値は論理ペンを識別するハンドル。失敗した場合は NULL。

[備考]
論理ペン作成後、SelectObject で DC に選択して線や曲線を描画できる。nWidth が 0 の場合、現在の変換に関わらず線は
1 ピクセル幅。nWidth が 1 より大きい場合、fnPenStyle は
PS_NULL、PS_SOLID、PS_INSIDEFRAME
のいずれかでなければならない。PS_DASH、PS_DOT、PS_DASHDOT、PS_DASHDOTDOT
を使う場合、破線間のギャップを透明にするには SetBkMode で TRANSPARENT を設定する。不要になったら
DeleteObject で削除する。

情報