GraphicsPath.AddClosedCurve Methode

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Fügt diesem Pfad eine geschlossene Kurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.

Überlädt

AddClosedCurve(Point[])	Fügt diesem Pfad eine geschlossene Kurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.
AddClosedCurve(PointF[])	Fügt diesem Pfad eine geschlossene Kurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.
AddClosedCurve(Point[], Single)	Fügt diesem Pfad eine geschlossene Kurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.
AddClosedCurve(PointF[], Single)	Fügt diesem Pfad eine geschlossene Kurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.

AddClosedCurve(Point[])

Quelle:

GraphicsPath.cs

Fügt diesem Pfad eine geschlossene Kurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.

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())

Parameter

points

Point[]

Ein Array von Point-Strukturen, das die Punkte für die Definition der Kurve darstellt.

Beispiele

Ein Beispiel finden Sie unter AddClosedCurve(Point[], Single).

Hinweise

Der Benutzer muss die ursprünglichen Punkte beibehalten, wenn sie benötigt werden. Die ursprünglichen Punkte werden intern in kubische Bézier-Kontrollpunkte konvertiert, daher gibt es keinen Mechanismus für die Rückgabe der ursprünglichen Punkte. Wenn der erste Punkt und der letzte Punkt im points Array nicht derselbe Punkt sind, wird die Kurve geschlossen, indem diese beiden Punkte miteinander verbunden werden. Der Spannungswert kann für diese Methode nicht festgelegt werden, und der Standardwert ist ein Wert, der 0,5 entspricht.

AddClosedCurve(PointF[])

Quelle:

GraphicsPath.cs

Fügt diesem Pfad eine geschlossene Kurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.

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())

Parameter

points

PointF[]

Ein Array von PointF-Strukturen, das die Punkte für die Definition der Kurve darstellt.

Beispiele

Ein Beispiel finden Sie unter AddClosedCurve(Point[], Single).

Hinweise

Der Benutzer muss die ursprünglichen Punkte beibehalten, wenn sie benötigt werden. Die ursprünglichen Punkte werden intern in kubische Bézier-Kontrollpunkte konvertiert, daher gibt es keinen Mechanismus für die Rückgabe der ursprünglichen Punkte. Wenn der erste Punkt und der letzte Punkt im points Array nicht derselbe Punkt sind, wird die Kurve geschlossen, indem diese beiden Punkte miteinander verbunden werden. Der Spannungswert kann für diese Methode nicht festgelegt werden, und der Standardwert ist ein Wert, der 0,5 entspricht.

AddClosedCurve(Point[], Single)

Quelle:

GraphicsPath.cs

Fügt diesem Pfad eine geschlossene Kurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.

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)

Parameter

points

Point[]

Ein Array von Point-Strukturen, das die Punkte für die Definition der Kurve darstellt.

tension

Single

Ein Wert zwischen 0 (null) und 1, der die Kurvenkrümmung zwischen den einzelnen Punkten angibt. 0  (null) stellt die kleinste Kurve (stärkste Krümmung) und 1 die am sanftesten gekrümmte Kurve dar.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, ein OnPaint Ereignisobjekt. Der Code führt die folgenden Aktionen aus:

• Erstellt ein Array von sechs Punkten (stellt eine Kardinalspline dar).

• Erstellt einen Pfad und fügt die geschlossenen Kardinalsplinekurven dem Pfad hinzu (geschlossen vom Endpunkt zum Ausgangspunkt).

• Zeichnet den Pfad zum Bildschirm.

Beachten Sie, dass eine Spannung von 0,5 verwendet wird.

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 symmetrical, 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 symmetrical, 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

Hinweise

Der Benutzer muss die ursprünglichen Punkte beibehalten, wenn sie benötigt werden. Die ursprünglichen Punkte werden intern in kubische Bézier-Kontrollpunkte konvertiert, daher gibt es keinen Mechanismus für die Rückgabe der ursprünglichen Punkte. Wenn der erste Punkt und der letzte Punkt im points Array nicht derselbe Punkt sind, wird die Kurve geschlossen, indem diese beiden Punkte miteinander verbunden werden.

AddClosedCurve(PointF[], Single)

Quelle:

GraphicsPath.cs

Fügt diesem Pfad eine geschlossene Kurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.

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)

Parameter

points

PointF[]

Ein Array von PointF-Strukturen, das die Punkte für die Definition der Kurve darstellt.

tension

Single

Ein Wert zwischen 0 (null) und 1, der die Kurvenkrümmung zwischen den einzelnen Punkten angibt. 0  (null) stellt die kleinste Kurve (stärkste Krümmung) und 1 die am sanftesten gekrümmte Kurve dar.

Beispiele

Ein Beispiel finden Sie unter AddClosedCurve(Point[], Single).

Hinweise

Der Benutzer muss die ursprünglichen Punkte beibehalten, wenn sie benötigt werden. Die ursprünglichen Punkte werden intern in kubische Bézier-Kontrollpunkte konvertiert, daher gibt es keinen Mechanismus für die Rückgabe der ursprünglichen Punkte. Wenn der erste Punkt und der letzte Punkt im points Array nicht derselbe Punkt sind, wird die Kurve geschlossen, indem diese beiden Punkte miteinander verbunden werden.