GraphicsPath.AddCurve メソッド

定義

現在の図形にスプライン曲線を追加します。Adds a spline curve to the current figure. 曲線は配列内の各点を結ぶため、カーディナル スプライン曲線を使用します。A cardinal spline curve is used because the curve travels through each of the points in the array.

オーバーロード

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

現在の図形にスプライン曲線を追加します。Adds a spline curve to the current figure.

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

現在の図形にスプライン曲線を追加します。Adds a spline curve to the current figure.

AddCurve(PointF[], Single)

現在の図形にスプライン曲線を追加します。Adds a spline curve to the current figure.

AddCurve(PointF[])

現在の図形にスプライン曲線を追加します。Adds a spline curve to the current figure. 曲線は配列内の各点を結ぶため、カーディナル スプライン曲線を使用します。A cardinal spline curve is used because the curve travels through each of the points in the array.

AddCurve(Point[])

現在の図形にスプライン曲線を追加します。Adds a spline curve to the current figure. 曲線は配列内の各点を結ぶため、カーディナル スプライン曲線を使用します。A cardinal spline curve is used because the curve travels through each of the points in the array.

AddCurve(Point[], Single)

現在の図形にスプライン曲線を追加します。Adds a spline curve to the current figure.

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

現在の図形にスプライン曲線を追加します。Adds a spline curve to the current figure.

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 構造体の配列。An array of PointF structures that represents the points that define the curve.

offset
Int32

曲線の最初の点として使用される、points 配列の要素のインデックス。The index of the element in the points array that is used as the first point in the curve.

numberOfSegments
Int32

曲線の描画に使用されるセグメントの数。The number of segments used to draw the curve. セグメントは、2 つの点を接続する直線と見なすことができます。A segment can be thought of as a line connecting two points.

tension
Single

曲線が制御点の間で湾曲する度合いを指定する値。A value that specifies the amount that the curve bends between control points. 1 より大きい値の場合、予期しない結果が発生します。Values greater than 1 produce unpredictable results.

例については、「AddCurve(Point[], Int32, Int32, Single)」を参照してください。For an example, see AddCurve(Point[], Int32, Int32, Single).

注釈

ユーザーは、必要に応じて元のポイントを保持する必要があります。The user must keep the original points if they are needed. 元の点は、内部的に3次ベジエコントロールポイントに変換されるため、元の点を返す機構はありません。The original points are converted to cubic Bézier control points internally, therefore there is no mechanism for returning the original points.

曲線は、によって指定された配列の点から開始 offset し、で指定された点 (セグメント) の数を含み numberOfSegments ます。The curve begins at the point in the array specified by offset, and includes the number of points (segments) specified by numberOfSegments.

適用対象

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

現在の図形にスプライン曲線を追加します。Adds a spline curve to the current figure.

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 構造体の配列。An array of Point structures that represents the points that define the curve.

offset
Int32

曲線の最初の点として使用される、points 配列の要素のインデックス。The index of the element in the points array that is used as the first point in the curve.

numberOfSegments
Int32

曲線が制御点の間で湾曲する度合いを指定する値。A value that specifies the amount that the curve bends between control points. 1 より大きい値の場合、予期しない結果が発生します。Values greater than 1 produce unpredictable results.

tension
Single

曲線が制御点の間で湾曲する度合いを指定する値。A value that specifies the amount that the curve bends between control points. 1 より大きい値の場合、予期しない結果が発生します。Values greater than 1 produce unpredictable results.

次のコード例は、Windows フォームで使用するように設計されており、イベントオブジェクトを必要とし PaintEventArgs e OnPaint ます。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, an OnPaint event object. コードは、次のアクションを実行します。The code performs the following actions:

  • 4つの点の配列を作成します (カーディナルスプラインを表します)。Creates an array of four points (representing a cardinal spline).

  • パスを作成し、ポイントの配列を使用して、曲線をパスに追加します。Creates a path and using the array of points, adds the curve to the path.

  • 画面へのパスを描画します。Draws the path to the screen.

配列には4つのポイントが保持されますが、の呼び出しの3番目の引数で指定された数のセグメントのみが存在することに注意 AddCurve してください。Notice that while the array holds four points, there are only three segments, which is the number specified in the third argument of the call to AddCurve.

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

注釈

ユーザーは、必要に応じて元のポイントを保持する必要があります。The user must keep the original points if they are needed. 元の点は、内部的に3次ベジエコントロールポイントに変換されるため、元の点を返す機構はありません。The original points are converted to cubic Bézier control points internally, therefore there is no mechanism for returning the original points.

曲線は、パラメーターによって指定された配列内の位置から開始し、 offset で指定された点 (セグメント) の数を含み numberOfSegments ます。The curve begins at the point in the array specified by the offset parameter and includes the number of points (segments) specified by numberOfSegments.

適用対象

AddCurve(PointF[], Single)

現在の図形にスプライン曲線を追加します。Adds a spline curve to the current figure.

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 構造体の配列。An array of PointF structures that represents the points that define the curve.

tension
Single

曲線が制御点の間で湾曲する度合いを指定する値。A value that specifies the amount that the curve bends between control points. 1 より大きい値の場合、予期しない結果が発生します。Values greater than 1 produce unpredictable results.

例については、「AddCurve(Point[], Int32, Int32, Single)」を参照してください。For an example, see AddCurve(Point[], Int32, Int32, Single).

注釈

ユーザーは、必要に応じて元のポイントを保持する必要があります。The user must keep the original points if they are needed. 元の点は、内部的に3次ベジエコントロールポイントに変換されるため、元の点を返す機構はありません。The original points are converted to cubic Bézier control points internally, therefore there is no mechanism for returning the original points.

適用対象

AddCurve(PointF[])

現在の図形にスプライン曲線を追加します。Adds a spline curve to the current figure. 曲線は配列内の各点を結ぶため、カーディナル スプライン曲線を使用します。A cardinal spline curve is used because the curve travels through each of the points in the array.

public:
 void AddCurve(cli::array <System::Drawing::PointF> ^ points);
public void AddCurve (System.Drawing.PointF[] points);
member this.AddCurve : System.Drawing.PointF[] -> unit
Public Sub AddCurve (points As PointF())

パラメーター

points
PointF[]

曲線を定義する複数の点を表す PointF 構造体の配列。An array of PointF structures that represents the points that define the curve.

例については、「AddCurve(Point[], Int32, Int32, Single)」を参照してください。For an example, see AddCurve(Point[], Int32, Int32, Single).

注釈

ユーザーは、必要に応じて元のポイントを保持する必要があります。The user must keep the original points if they are needed. 元の点は、内部的に3次ベジエコントロールポイントに変換されるため、元の点を返す機構はありません。The original points are converted to cubic Bézier control points internally, therefore there is no mechanism for returning the original points.

適用対象

AddCurve(Point[])

現在の図形にスプライン曲線を追加します。Adds a spline curve to the current figure. 曲線は配列内の各点を結ぶため、カーディナル スプライン曲線を使用します。A cardinal spline curve is used because the curve travels through each of the points in the array.

public:
 void AddCurve(cli::array <System::Drawing::Point> ^ points);
public void AddCurve (System.Drawing.Point[] points);
member this.AddCurve : System.Drawing.Point[] -> unit
Public Sub AddCurve (points As Point())

パラメーター

points
Point[]

曲線を定義する複数の点を表す Point 構造体の配列。An array of Point structures that represents the points that define the curve.

例については、「AddClosedCurve(Point[], Single)」を参照してください。For an example, see AddClosedCurve(Point[], Single).

注釈

ユーザーは、必要に応じて元のポイントを保持する必要があります。The user must keep the original points if they are needed. 元の点は、内部的に3次ベジエコントロールポイントに変換されるため、元の点を返す機構はありません。The original points are converted to cubic Bézier control points internally, therefore there is no mechanism for returning the original points.

適用対象

AddCurve(Point[], Single)

現在の図形にスプライン曲線を追加します。Adds a spline curve to the current figure.

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 構造体の配列。An array of Point structures that represents the points that define the curve.

tension
Single

曲線が制御点の間で湾曲する度合いを指定する値。A value that specifies the amount that the curve bends between control points. 1 より大きい値の場合、予期しない結果が発生します。Values greater than 1 produce unpredictable results.

例については、「AddClosedCurve(Point[], Single)」を参照してください。For an example, see AddClosedCurve(Point[], Single).

注釈

ユーザーは、必要に応じて元のポイントを保持する必要があります。The user must keep the original points if they are needed. 元の点は、内部的に3次ベジエコントロールポイントに変換されるため、元の点を返す機構はありません。The original points are converted to cubic Bézier control points internally, therefore there is no mechanism for returning the original points.

適用対象