CreatePen 関数 (wingdi.h)

CreatePen 関数は、指定されたスタイル、幅、色を持つ論理ペンを作成します。 その後、ペンをデバイス コンテキストに選択し、線と曲線を描画するために使用できます。

構文

HPEN CreatePen(
  [in] int      iStyle,
  [in] int      cWidth,
  [in] COLORREF color
);

パラメーター

[in] iStyle

ペン スタイル。 次のいずれかの値を指定できます。

[in] cWidth

ペンの幅 (論理単位)。 nWidth が 0 の場合、現在の変換に関係なく、ペンの幅は 1 ピクセルです。

CreatePen は 、次のスタイルに 1 より大きい幅を指定した場合は、指定した幅のペンをPS_SOLIDスタイルで返します:PS_DASH、PS_DOT、PS_DASHDOT、PS_DASHDOTDOT。

[in] color

ペンの色の色参照。 COLORREF 構造体を生成するには、RGB マクロを使用します。

戻り値

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

関数が失敗した場合は、返される値は NULL です。

注釈

アプリケーションは、論理ペンを作成した後、 SelectObject 関数を呼び出すことによって、そのペンをデバイス コンテキストに選択できます。 ペンをデバイス コンテキストに選択した後、線と曲線を描画するために使用できます。

nWidth パラメーターで指定された値が 0 の場合、作成されたペンで描画される線は、現在の変換に関係なく、常に 1 ピクセル幅になります。

nWidth で指定された値が 1 より大きい場合、fnPenStyle パラメーターは、PS_NULL、PS_SOLID、またはPS_INSIDEFRAMEである必要があります。

nWidth で指定された値が 1 より大きく、fnPenStyle がPS_INSIDEFRAME場合、ペンに関連付けられている線は、ポリゴンとポリラインを除くすべてのプリミティブのフレーム内に描画されます。

nWidth で指定された値が 1 より大きい場合、fnPenStyle はPS_INSIDEFRAMEされ、crColor パラメーターで指定された色が論理パレット内のエントリの 1 つと一致しない場合、システムはディザリングされた色を使用して線を描画します。 ディザリングされた色は、実線ペンでは使用できません。

PS_DASH、PS_DOT、PS_DASHDOT、またはPS_DASHDOTDOTの iStyle パラメーターを使用する場合、ダッシュまたはドット間のギャップを透明にするには 、SetBkMode を使用してモードを TRANSPARENT に設定します。

ペンが不要になったら、 DeleteObject 関数を呼び出して削除します。

Icm： 作成時に色管理は行われません。 ただし、カラー管理は、ペンが ICM 対応デバイス コンテキストに選択されたときに実行されます。

例

例については、「 色付きペンとブラシの作成」を参照してください。

要件

こちらもご覧ください

COLORREF

CreatePenIndirect

DeleteObject

ExtCreatePen

GetObject

ペン関数

ペンの概要

RGB

Selectobject