GraphicsPath::AddCurve(constPointF*,INT) メソッド (gdipluspath.h)

[アーティクル]
02/29/2024

GraphicsPath::AddCurve メソッドは、このパスの現在の図にカーディナルスプラインを追加します。

構文

Status AddCurve(
  const PointF *points,
  INT          count
);

パラメーター

points

カーディナルスプラインを定義するポイントの配列へのポインター。カーディナルスプラインは、配列内の各ポイントを通過する曲線です。

count

ポイント配列内の要素の数を指定する整数。

戻り値

Type:Status

メソッドが成功した場合は、 Status 列挙の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

注釈

これらのポイントが後で必要になる場合は、points 配列のコピーを保持する必要があります。 GraphicsPath オブジェクトには、AddClosedCurve メソッドに渡されたポイントは格納されません。代わりに、カーディナルスプラインをベジエスプラインのシーケンスに変換し、それらのベジエスプラインを定義する点を格納します。 GraphicsPath オブジェクトからポイントの元の配列を取得することはできません。

例

次の例では、 GraphicsPath オブジェクトパスを作成し、パスにカーディナルスプラインを追加してから、パスを描画します。

VOID AddCurveExample(HDC hdc)
{
   Graphics graphics(hdc);
   PointF pts[] = {PointF(50.0f, 50.0f),
                   PointF(60.0f, 20.0f),
                   PointF(70.0f, 100.0f),
                   PointF(80.0f, 50.0f)};
   GraphicsPath path;
   path.AddCurve(pts, 4);
   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}