GraphicsPath.AddCurve Methode

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

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

Überlädt

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

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

Quelle:

GraphicsPath.cs

Fügt der aktuellen Figur eine Splinekurve hinzu.

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)

Parameter

points

PointF[]

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

offset

Int32

Der Index des Elements im points-Array, das als erster Punkt der Kurve verwendet wird.

numberOfSegments

Int32

Die zum Zeichnen der Kurve verwendete Anzahl von Segmenten. Ein Segment kann als Linie aufgefasst werden, die zwei Punkte verbindet.

tension

Single

Ein Wert, der die Kurvenkrümmung zwischen Kontrollpunkten angibt. Werte, die größer als 1 sind, führen zu unvorhersehbaren Ergebnissen.

Beispiele

Ein Beispiel finden Sie unter AddCurve(Point[], Int32, Int32, 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.

Die Kurve beginnt an dem Punkt im Array, der von angegeben wird offset, und enthält die Anzahl der Punkte (Segmente), die durch angegeben wird numberOfSegments.

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

Quelle:

GraphicsPath.cs

Fügt der aktuellen Figur eine Splinekurve hinzu.

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)

Parameter

points

Point[]

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

offset

Int32

Der Index des Elements im points-Array, das als erster Punkt der Kurve verwendet wird.

numberOfSegments

Int32

Ein Wert, der die Kurvenkrümmung zwischen Kontrollpunkten angibt. Werte, die größer als 1 sind, führen zu unvorhersehbaren Ergebnissen.

tension

Single

Ein Wert, der die Kurvenkrümmung zwischen Kontrollpunkten angibt. Werte, die größer als 1 sind, führen zu unvorhersehbaren Ergebnissen.

Beispiele

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

• Erstellt ein Array von vier Punkten (stellt einen Kardinalspline dar).

• Erstellt einen Pfad, und fügt die Kurve mithilfe des Arrays von Punkten dem Pfad hinzu.

• Zeichnet den Pfad zum Bildschirm.

Beachten Sie, dass das Array zwar vier Punkte enthält, es jedoch nur drei Segmente gibt. Dies ist die zahl, die im dritten Argument des Aufrufs AddCurvevon angegeben ist.

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

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.

Die Kurve beginnt an dem Punkt im Array, der durch den offset -Parameter angegeben wird, und enthält die Anzahl von Punkten (Segmenten), die durch angegeben wird numberOfSegments.

AddCurve(PointF[], Single)

Quelle:

GraphicsPath.cs

Fügt der aktuellen Figur eine Splinekurve hinzu.

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)

Parameter

points

PointF[]

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

tension

Single

Ein Wert, der die Kurvenkrümmung zwischen Kontrollpunkten angibt. Werte, die größer als 1 sind, führen zu unvorhersehbaren Ergebnissen.

Beispiele

Ein Beispiel finden Sie unter AddCurve(Point[], Int32, Int32, 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.

AddCurve(Point[])

Quelle:

GraphicsPath.cs

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

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

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.

AddCurve(PointF[])

Quelle:

GraphicsPath.cs

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

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

Parameter

points

PointF[]

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

Beispiele

Ein Beispiel finden Sie unter AddCurve(Point[], Int32, Int32, 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.

AddCurve(Point[], Single)

Quelle:

GraphicsPath.cs

Fügt der aktuellen Figur eine Splinekurve hinzu.

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)

Parameter

points

Point[]

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

tension

Single

Ein Wert, der die Kurvenkrümmung zwischen Kontrollpunkten angibt. Werte, die größer als 1 sind, führen zu unvorhersehbaren Ergebnissen.

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.