GraphicsPath.AddClosedCurve メソッド

定義

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

オーバーロード

AddClosedCurve(Point[])

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

AddClosedCurve(PointF[])

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

AddClosedCurve(Point[], Single)

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

AddClosedCurve(PointF[], Single)

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

AddClosedCurve(Point[])

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

public:
 void AddClosedCurve(cli::array <System::Drawing::Point> ^ points);
public void AddClosedCurve (System.Drawing.Point[] points);
member this.AddClosedCurve : System.Drawing.Point[] -> unit
Public Sub AddClosedCurve (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. 配列内の最初の点と最後の点が points 同じでない場合、曲線は、これらの2つの点を結ぶことによって閉じられます。If the first point and the last point in the points array are not the same point, the curve is closed by connecting these two points. このメソッドにテンション値を設定することはできません。既定値は0.5 に相当します。The tension value cannot be set for this method, and defaults to a value equivalent to 0.5.

適用対象

AddClosedCurve(PointF[])

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

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

パラメーター

points
PointF[]

曲線を定義する複数の点を表す PointF 構造体の配列。An array of PointF 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. 配列内の最初の点と最後の点が points 同じでない場合、曲線は、これらの2つの点を結ぶことによって閉じられます。If the first point and the last point in the points array are not the same point, the curve is closed by connecting these two points. このメソッドにテンション値を設定することはできません。既定値は0.5 に相当します。The tension value cannot be set for this method, and defaults to a value equivalent to 0.5.

適用対象

AddClosedCurve(Point[], Single)

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

public:
 void AddClosedCurve(cli::array <System::Drawing::Point> ^ points, float tension);
public void AddClosedCurve (System.Drawing.Point[] points, float tension);
member this.AddClosedCurve : System.Drawing.Point[] * single -> unit
Public Sub AddClosedCurve (points As Point(), tension As Single)

パラメーター

points
Point[]

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

tension
Single

曲線が点の間で湾曲する度合いを指定する 0 ~ 1 の値。0 が最小 (急な曲線) で、1 の場合に最も滑らかな曲線になります。A value between from 0 through 1 that specifies the amount that the curve bends between points, with 0 being the smallest curve (sharpest corner) and 1 being the smoothest curve.

次のコード例は、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:

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

  • パスを作成し、閉じたカーディナルスプライン曲線をパス (エンドポイントから開始点まで) に追加します。Creates a path and adds the closed cardinal spline curves to the path (closed from the endpoint to the starting point).

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

0.5 のテンションが使用されていることに注意してください。Notice that a tension of 0.5 is used.

private:
   void AddClosedCurveExample( PaintEventArgs^ e )
   {
      // Creates a symetrical, closed curve.
      array<Point>^ myArray = {Point(20,100),Point(40,150),Point(60,125),Point(40,100),Point(60,75),Point(40,50)};

      // Create a new path and add curve.
      GraphicsPath^ myPath = gcnew GraphicsPath;
      myPath->AddClosedCurve( myArray, .5f );
      Pen^ myPen = gcnew Pen( Color::Black,2.0f );

      // Draw the path to screen.
      e->Graphics->DrawPath( myPen, myPath );
   }
private void AddClosedCurveExample(PaintEventArgs e)
{
             
    // Creates a symetrical, closed curve.
    Point[] myArray =
             {
                 new Point(20,100),
                 new Point(40,150),
                 new Point(60,125),
                 new Point(40,100),
                 new Point(60,75),
                 new Point(40,50)
             };
             
    // Create a new path and add curve.
    GraphicsPath myPath = new GraphicsPath();
    myPath.AddClosedCurve(myArray,.5f);
    Pen myPen = new Pen(Color.Black, 2);
             
    // Draw the path to screen.
    e.Graphics.DrawPath(myPen, myPath);
}
Public Sub AddClosedCurveExample(ByVal e As PaintEventArgs)

    ' Creates a symetrical, closed curve.
    Dim myArray As Point() = {New Point(20, 100), New Point(40, 150), _
    New Point(60, 125), New Point(40, 100), New Point(60, 75), _
    New Point(40, 50)}
    Dim myPath As New GraphicsPath
    myPath.AddClosedCurve(myArray, 0.5F)
    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. 配列内の最初の点と最後の点が points 同じでない場合、曲線は、これらの2つの点を結ぶことによって閉じられます。If the first point and the last point in the points array are not the same point, the curve is closed by connecting these two points.

適用対象

AddClosedCurve(PointF[], Single)

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

public:
 void AddClosedCurve(cli::array <System::Drawing::PointF> ^ points, float tension);
public void AddClosedCurve (System.Drawing.PointF[] points, float tension);
member this.AddClosedCurve : System.Drawing.PointF[] * single -> unit
Public Sub AddClosedCurve (points As PointF(), tension As Single)

パラメーター

points
PointF[]

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

tension
Single

曲線が点の間で湾曲する度合いを指定する 0 ~ 1 の値。0 が最小 (急な曲線) で、1 の場合に最も滑らかな曲線になります。A value between from 0 through 1 that specifies the amount that the curve bends between points, with 0 being the smallest curve (sharpest corner) and 1 being the smoothest 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. 配列内の最初の点と最後の点が points 同じでない場合、曲線は、これらの2つの点を結ぶことによって閉じられます。If the first point and the last point in the points array are not the same point, the curve is closed by connecting these two points.

適用対象