CPen::CPen

CPen( );

CPen ( int nPenStyle, int nWidth, COLORREF crColor );
スロー ( CResourceException );

CPen ( int nPenStyle, int nWidth, const LOGBRUSH ※ pLogBrush, int nStyleCount = 0、 const DWORD ※ lpStyle = NULL );
スロー ( CResourceException );

パラメーター

nPenStyle

ペンのスタイルを指定します。このパラメーターは、コンス トラクターの最初のバージョンでは、次の値のいずれかをすることができます。:

• PS_SOLID特価;ソリッド ペンを作成します。(&N)。
  
  
• PS_DASH特価;破線のペンを作成します。ペンの幅が 1 以下、デバイスでのユニットの場合にのみ有効(&N)。
  
  
• PS_DOT特価;点線ペンを作成します。ペンの幅が 1 以下、デバイスでのユニットの場合にのみ有効(&N)。
  
  
• PS_DASHDOT特価;ダッシュとドットの交互にペンを作成します。ペンの幅が 1 以下、デバイスでのユニットの場合にのみ有効(&N)。
  
  
• PS_DASHDOTDOT特価;ダッシュとドットのダブルを交互にペンを作成します。ペンの幅が 1 以下、デバイスでのユニットの場合にのみ有効(&N)。
  
  
• PS_NULL特価;Null ペンを作成します。(&N)。
  
  
• PS_INSIDEFRAME特価;外接する四角形 (たとえば、楕円、四角形、 RoundRect、パイと和音メンバー関数) を指定、Windows GDI 出力関数によって生成された閉じた図形の枠線を描画するペンを作成します。このスタイルは、外接する四角形 (たとえば、 LineToメンバー関数) を指定しない Windows GDI 出力関数と組み合わせて使用すると、ペンの描画領域の枠に制限はないです。(&N)。

  CPenコンス トラクターの 2 番目のバージョンでは、種類、スタイル、エンド キャップ、結合の属性の組み合わせを指定します。各カテゴリの値は、ビットごとの OR 演算子 (|) を使用して結合する必要があります。ペンの種類は、次の値のいずれかをすることができます。:

• PS_GEOMETRIC特価;ジオメトリック ペンを作成します。(&N)。
  
  
• PS_COSMETIC特価;コスメティック ペンを作成します。(&N)。

  CPenコンス トラクターの 2 番目のバージョンの次のペン スタイルnPenStyleの追加します。:

• PS_ALTERNATE特価;他のすべてのピクセルを設定、ペンを作成します。(このスタイルはコスメティック ペンだけに適用されます。)(&N)
  
  
• PS_USERSTYLE特価;ユーザーが指定したスタイルの配列を使用して、ペンを作成します。(&N)。

  エンド キャップは、次の値のいずれかをすることができます。:

• PS_ENDCAP_ROUND特価;エンド キャップのラウンドです。(&N)。
  
  
• PS_ENDCAP_SQUARE特価;エンド キャップが正方形であります。(&N)。
  
  
• PS_ENDCAP_FLAT特価;エンド キャップはフラットです。(&N)。

  結合は、次の値のいずれかをすることができます。:

• PS_JOIN_BEVEL特価;斜めに結合しています。(&N)。
  
  
• PS_JOIN_MITER特価;結合されるマイターベンドは設定、現在の制限内にある場合、 :: SetMiterLimit機能。結合がこの制限を超える場合は、それを斜めです。(&N)。
  
  
• PS_JOIN_ROUND特価;結合のラウンドです。(&N)。

nWidth

ペンの幅を指定します。

• この値が 0 の場合、コンス トラクターの最初のバージョンは、デバイス単位で幅マッピング モードに関係なく、1 ピクセルでは。
  
  
• PS_GEOMETRIC、 nPenStyleである場合、コンス トラクターの 2 番目のバージョンは、論理単位で幅を与えられます。NPenStyleがPS_COSMETICの場合は、幅が 1 に設定する必要があります。

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にする必要があります。

解説

引数を指定しないコンス トラクターを使用する場合は、 CPenオブジェクトCreatePen、 CreatePenIndirect、またはCreateStockObjectのメンバー関数で初期化する必要があります。引数を受け取るコンス トラクターを使用する場合は、さらに初期化は必要ありません。引数なしのコンス トラクターが常に成功しますが、エラーが場合、コンス トラクター引数で例外をスローすることができます。

CPen の概要|nbsp;クラス メンバー |階層図(&N)

参照特価;CPen::CreatePen、 CPen::CreatePenIndirect、 CGdiObject::CreateStockObject(&N)