GraphicsPath.AddCurve メソッド

定義

名前空間:

System.Drawing.Drawing2D

アセンブリ:

System.Drawing.Common.dll

パッケージ:

System.Drawing.Common v9.0.0-preview.7.24405.4

現在の図形にスプライン曲線を追加します。 カーディナル スプライン曲線が使用されるのは、曲線が配列内の各ポイントを通過するためです。

オーバーロード

AddCurve(PointF[], Int32, Int32, Single)	現在の図形にスプライン曲線を追加します。
AddCurve(Point[], Int32, Int32, Single)	現在の図形にスプライン曲線を追加します。
AddCurve(PointF[], Single)	現在の図形にスプライン曲線を追加します。
AddCurve(Point[])	現在の図形にスプライン曲線を追加します。 カーディナル スプライン曲線が使用されるのは、曲線が配列内の各ポイントを通過するためです。
AddCurve(PointF[])	現在の図形にスプライン曲線を追加します。 カーディナル スプライン曲線が使用されるのは、曲線が配列内の各ポイントを通過するためです。
AddCurve(Point[], Single)	現在の図形にスプライン曲線を追加します。

AddCurve(PointF[], Int32, Int32, Single)

ソース:

GraphicsPath.cs

現在の図形にスプライン曲線を追加します。

public:
 void AddCurve(cli::array <System::Drawing::PointF> ^ points, int offset, int numberOfSegments, float tension);

public void AddCurve (System.Drawing.PointF[] points, int offset, int numberOfSegments, float tension);

member this.AddCurve : System.Drawing.PointF[] * int * int * single -> unit

Public Sub AddCurve (points As PointF(), offset As Integer, numberOfSegments As Integer, tension As Single)

パラメーター

points

PointF[]

曲線を定義する点を表す PointF 構造体の配列。

offset

Int32

曲線の最初の点として使用される points 配列内の要素のインデックス。

numberOfSegments

Int32

曲線の描画に使用するセグメントの数。 セグメントは、2 つの点を結ぶ線と考えることができます。

tension

Single

コントロール ポイント間でカーブが曲がる量を指定する値。 1 より大きい値を指定すると、予期しない結果が発生します。

例

例については、AddCurve(Point[], Int32, Int32, Single)を参照してください。

注釈

ユーザーは、必要に応じて元のポイントを保持する必要があります。 元の点は内部的に 3 次ベジエ制御点に変換されるため、元の点を返すメカニズムはありません。

曲線は、offsetで指定された配列内のポイントから始まり、numberOfSegmentsで指定されたポイント (セグメント) の数が含まれます。

AddCurve(Point[], Int32, Int32, Single)

ソース:

GraphicsPath.cs

現在の図形にスプライン曲線を追加します。

public:
 void AddCurve(cli::array <System::Drawing::Point> ^ points, int offset, int numberOfSegments, float tension);

public void AddCurve (System.Drawing.Point[] points, int offset, int numberOfSegments, float tension);

member this.AddCurve : System.Drawing.Point[] * int * int * single -> unit

Public Sub AddCurve (points As Point(), offset As Integer, numberOfSegments As Integer, tension As Single)

パラメーター

points

Point[]

曲線を定義する点を表す Point 構造体の配列。

offset

Int32

曲線の最初の点として使用される points 配列内の要素のインデックス。

numberOfSegments

Int32

コントロール ポイント間でカーブが曲がる量を指定する値。 1 より大きい値を指定すると、予期しない結果が発生します。

tension

Single

コントロール ポイント間でカーブが曲がる量を指定する値。 1 より大きい値を指定すると、予期しない結果が発生します。

例

次のコード例は、Windows フォームで使用できるように設計されており、OnPaint イベント オブジェクトである PaintEventArgseが必要です。 このコードは、次のアクションを実行します。

• (カーディナル スプラインを表す) 4 つの点の配列を作成します。

• パスを作成し、ポイントの配列を使用して、パスに曲線を追加します。

• 画面へのパスを描画します。

配列には 4 つのポイントがありますが、3 つのセグメントのみが存在します。これは、AddCurveの呼び出しの 3 番目の引数で指定された番号です。

private:
   void AddCurveExample( PaintEventArgs^ e )
   {
      // Create some points.
      Point point1 = Point(20,20);
      Point point2 = Point(40,0);
      Point point3 = Point(60,40);
      Point point4 = Point(80,20);

      // Create an array of the points.
      array<Point>^ curvePoints = {point1,point2,point3,point4};

      // Create a GraphicsPath object and add a curve.
      GraphicsPath^ myPath = gcnew GraphicsPath;
      myPath->AddCurve( curvePoints, 0, 3, 0.8f );

      // Draw the path to the screen.
      Pen^ myPen = gcnew Pen( Color::Black,2.0f );
      e->Graphics->DrawPath( myPen, myPath );
   }

private void AddCurveExample(PaintEventArgs e)
{
             
    // Create some points.
    Point point1 = new Point(20, 20);
    Point point2 = new Point(40, 0);
    Point point3 = new Point(60, 40);
    Point point4 = new Point(80, 20);
             
    // Create an array of the points.
    Point[] curvePoints = {point1, point2, point3, point4};
             
    // Create a GraphicsPath object and add a curve.
    GraphicsPath myPath = new GraphicsPath();
    myPath.AddCurve(curvePoints, 0, 3, 0.8f);
             
    // Draw the path to the screen.
    Pen myPen = new Pen(Color.Black, 2);
    e.Graphics.DrawPath(myPen, myPath);
}

Public Sub AddCurveExample(ByVal e As PaintEventArgs)

    ' Create some points.
    Dim point1 As New Point(20, 20)
    Dim point2 As New Point(40, 0)
    Dim point3 As New Point(60, 40)
    Dim point4 As New Point(80, 20)

    ' Create an array of the points.
    Dim curvePoints As Point() = {point1, point2, point3, point4}

    ' Create a GraphicsPath object and add a curve.
    Dim myPath As New GraphicsPath
    myPath.AddCurve(curvePoints, 0, 3, 0.8F)

    ' Draw the path to the screen.
    Dim myPen As New Pen(Color.Black, 2)
    e.Graphics.DrawPath(myPen, myPath)
End Sub

注釈

ユーザーは、必要に応じて元のポイントを保持する必要があります。 元の点は内部的に 3 次ベジエ制御点に変換されるため、元の点を返すメカニズムはありません。

曲線は、offset パラメーターで指定された配列内のポイントから始まり、numberOfSegmentsで指定されたポイント (セグメント) の数が含まれます。

AddCurve(PointF[], Single)

ソース:

GraphicsPath.cs

現在の図形にスプライン曲線を追加します。

public:
 void AddCurve(cli::array <System::Drawing::PointF> ^ points, float tension);

public void AddCurve (System.Drawing.PointF[] points, float tension);

member this.AddCurve : System.Drawing.PointF[] * single -> unit

Public Sub AddCurve (points As PointF(), tension As Single)

パラメーター

points

PointF[]

曲線を定義する点を表す PointF 構造体の配列。

tension

Single

コントロール ポイント間でカーブが曲がる量を指定する値。 1 より大きい値を指定すると、予期しない結果が発生します。

例

例については、AddCurve(Point[], Int32, Int32, Single)を参照してください。

注釈

ユーザーは、必要に応じて元のポイントを保持する必要があります。 元の点は内部的に 3 次ベジエ制御点に変換されるため、元の点を返すメカニズムはありません。

AddCurve(Point[])

ソース:

GraphicsPath.cs

現在の図形にスプライン曲線を追加します。 カーディナル スプライン曲線が使用されるのは、曲線が配列内の各ポイントを通過するためです。

public:
 void AddCurve(... cli::array <System::Drawing::Point> ^ points);

public void AddCurve (params System.Drawing.Point[] points);

member this.AddCurve : System.Drawing.Point[] -> unit

Public Sub AddCurve (ParamArray points As Point())

パラメーター

points

Point[]

曲線を定義する点を表す Point 構造体の配列。

例

例については、AddClosedCurve(Point[], Single)を参照してください。

注釈

ユーザーは、必要に応じて元のポイントを保持する必要があります。 元の点は内部的に 3 次ベジエ制御点に変換されるため、元の点を返すメカニズムはありません。

AddCurve(PointF[])

ソース:

GraphicsPath.cs

現在の図形にスプライン曲線を追加します。 カーディナル スプライン曲線が使用されるのは、曲線が配列内の各ポイントを通過するためです。

public:
 void AddCurve(... cli::array <System::Drawing::PointF> ^ points);

public void AddCurve (params System.Drawing.PointF[] points);

member this.AddCurve : System.Drawing.PointF[] -> unit

Public Sub AddCurve (ParamArray points As PointF())

パラメーター

points

PointF[]

曲線を定義する点を表す PointF 構造体の配列。

例

例については、AddCurve(Point[], Int32, Int32, Single)を参照してください。

注釈

ユーザーは、必要に応じて元のポイントを保持する必要があります。 元の点は内部的に 3 次ベジエ制御点に変換されるため、元の点を返すメカニズムはありません。

AddCurve(Point[], Single)

ソース:

GraphicsPath.cs

現在の図形にスプライン曲線を追加します。

public:
 void AddCurve(cli::array <System::Drawing::Point> ^ points, float tension);

public void AddCurve (System.Drawing.Point[] points, float tension);

member this.AddCurve : System.Drawing.Point[] * single -> unit

Public Sub AddCurve (points As Point(), tension As Single)

パラメーター

points

Point[]

曲線を定義する点を表す Point 構造体の配列。

tension

Single

コントロール ポイント間でカーブが曲がる量を指定する値。 1 より大きい値を指定すると、予期しない結果が発生します。

例

例については、AddClosedCurve(Point[], Single)を参照してください。

注釈

ユーザーは、必要に応じて元のポイントを保持する必要があります。 元の点は内部的に 3 次ベジエ制御点に変換されるため、元の点を返すメカニズムはありません。