BOOL CreatePen ( int nPenStyle, int nWidth, COLORREF crColor );
BOOL CreatePen ( int nPenStyle, int nWidth, const LOGBRUSH ※ pLogBrush, int nStyleCount = 0、 const DWORD ※ lpStyle = NULL );
戻り値
0 以外の値、または論理ペン、成功した場合のハンドル。そうでなければ 0。
パラメーター
nPenStyle
ペンのスタイルを指定します。使用可能な値の一覧についてを参照してください、 nPenStyleパラメーター、 CPenコンス トラクター。
nWidth
ペンの幅を指定します。
crColor
ペンの RGB カラーが含まれています。
pLogBrush
ポイントは LOGBRUSH構造体。NPenStyleがPS_COSMETICの場合は、 LOGBRUSH構造体のlbColorメンバーは、ペンの色を指定し、 lbStyleメンバー LOGBRUSH構造体のBS_SOLIDに設定する必要があります。NPenStyleがPS_GEOMETRICの場合は、すべてのメンバーが、ペンのブラシ属性の指定に使用する必要があります。
nStyleCount
長さ、 lpStyle配列のダブルワード単位を指定します。NPenStyle PS_USERSTYLEない場合はこの値は 0 にする必要があります。
lpStyle
ダブルワード値の配列へのポインター。最初の値をユーザー定義のスタイルで最初のダッシュの長さを指定します、最初のスペースの長さ、2 番目の値を指定します。NPenStyle PS_USERSTYLEがこのポインターをNULLにする必要があります。
解説
CreatePenの最初のバージョンでは、指定されたスタイル、幅、および色のペンを初期化します。ペンをその後、任意のデバイス コンテキストの現在のペンとして選択できます。
ペン幅が 1 ピクセルよりも大きいが常にPS_NULL、 PS_SOLID、またはPS_INSIDEFRAMEのいずれかのスタイルがあるはず。
ペン、ps_insideframeと論理カラー テーブルでカラーを一致しないカラーがある場合は、ペンをディザリングされた色で描画されます。PS_SOLIDのペン スタイル、ディザー カラーのペンを作成するのには使用できません。ペンの幅が 1 以下の場合スタイルPS_INSIDEFRAME PS_SOLIDすると同じです。
CreatePenの 2 番目のバージョンでは、指定されたスタイル、幅、ブラシ属性を持つ、論理コスメティック ペンまたは幾何学ペンを初期化します。コスメティック ペンの幅は、常に 1 です。幾何学ペンの幅は、常に世界の単位で指定します。アプリケーションが論理ペンを作成した後、そのペンをデバイス コンテキストにCDC::SelectObjectを呼び出すことによって選択することができます 機能。ペンをデバイス コンテキストに選択されている後は、直線および曲線の描画に使用をされることができます。
アプリケーションは、もはや特定のペンが必要な場合は、それCGdiObject::DeleteObjectメンバー関数を呼び出すか、リソース使用ではありませんので、 CPenオブジェクトを破壊します。ペンをデバイス コンテキストに選択されている場合、アプリケーションは、ペンを削除しないでください。
CPen の概要|nbsp;クラス メンバー |階層図(&N)
参照特価;CPen::CreatePenIndirect、 CPen::CPen、 CGdiObject::DeleteObject、 LOGBRUSH(&N)