GraphicsPath.AddCurve Methode

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paket:

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

Fügt der aktuellen Abbildung eine Splinekurve hinzu. Eine Kardinal-Splinekurve wird verwendet, da die Kurve durch die einzelnen Punkte im Array verläuft.

Überlädt

AddCurve(PointF[], Int32, Int32, Single)	Fügt der aktuellen Abbildung eine Splinekurve hinzu.
AddCurve(Point[], Int32, Int32, Single)	Fügt der aktuellen Abbildung eine Splinekurve hinzu.
AddCurve(PointF[], Single)	Fügt der aktuellen Abbildung eine Splinekurve hinzu.
AddCurve(Point[])	Fügt der aktuellen Abbildung eine Splinekurve hinzu. Eine Kardinal-Splinekurve wird verwendet, da die Kurve durch die einzelnen Punkte im Array verläuft.
AddCurve(PointF[])	Fügt der aktuellen Abbildung eine Splinekurve hinzu. Eine Kardinal-Splinekurve wird verwendet, da die Kurve durch die einzelnen Punkte im Array verläuft.
AddCurve(Point[], Single)	Fügt der aktuellen Abbildung eine Splinekurve hinzu.

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

Quelle:

GraphicsPath.cs

Fügt der aktuellen Abbildung 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, die die Punkte darstellen, die die Kurve definieren.

offset

Int32

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

numberOfSegments

Int32

Die Anzahl der Segmente, die zum Zeichnen der Kurve verwendet werden. Ein Segment kann sich als Eine Linie angesehen werden, die zwei Punkte verbindet.

tension

Single

Ein Wert, der den Betrag angibt, den die Kurve zwischen Kontrollpunkten umkrümmt. 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 er erforderlich ist. 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 am Punkt in der Matrix, die durch offsetangegeben wird, und enthält die Anzahl der Punkte (Segmente), die durch numberOfSegmentsangegeben werden.

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

Quelle:

GraphicsPath.cs

Fügt der aktuellen Abbildung 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, die die Punkte darstellen, die die Kurve definieren.

offset

Int32

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

numberOfSegments

Int32

Ein Wert, der den Betrag angibt, den die Kurve zwischen Kontrollpunkten umkrümmt. Werte, die größer als 1 sind, führen zu unvorhersehbaren Ergebnissen.

tension

Single

Ein Wert, der den Betrag angibt, den die Kurve zwischen Kontrollpunkten umkrümmt. Werte, die größer als 1 sind, führen zu unvorhersehbaren Ergebnissen.

Beispiele

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

• Erstellt ein Array von vier Punkten (das eine Kardinalspline darstellt).

• Erstellt einen Pfad und verwendet das Array von Punkten, fügt die Kurve dem Pfad hinzu.

• Zeichnet den Pfad zum Bildschirm.

Beachten Sie, dass während das Array vier Punkte enthält, es gibt nur drei Segmente, die im dritten Argument des Aufrufs von AddCurveangegeben 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 er erforderlich ist. 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 am Punkt in dem Array, das durch den parameter offset angegeben wird, und enthält die Anzahl der Punkte (Segmente), die durch numberOfSegmentsangegeben werden.

AddCurve(PointF[], Single)

Quelle:

GraphicsPath.cs

Fügt der aktuellen Abbildung 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, die die Punkte darstellen, die die Kurve definieren.

tension

Single

Ein Wert, der den Betrag angibt, den die Kurve zwischen Kontrollpunkten umkrümmt. 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 er erforderlich ist. 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 Abbildung eine Splinekurve hinzu. Eine Kardinal-Splinekurve wird verwendet, da die Kurve durch die einzelnen Punkte im Array verläuft.

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

Parameter

points

Point[]

Ein Array von Point Strukturen, die die Punkte darstellen, die die Kurve definieren.

Beispiele

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

Hinweise

Der Benutzer muss die ursprünglichen Punkte beibehalten, wenn er erforderlich ist. 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 Abbildung eine Splinekurve hinzu. Eine Kardinal-Splinekurve wird verwendet, da die Kurve durch die einzelnen Punkte im Array verläuft.

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

Parameter

points

PointF[]

Ein Array von PointF Strukturen, die die Punkte darstellen, die die Kurve definieren.

Beispiele

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

Hinweise

Der Benutzer muss die ursprünglichen Punkte beibehalten, wenn er erforderlich ist. 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 Abbildung 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, die die Punkte darstellen, die die Kurve definieren.

tension

Single

Ein Wert, der den Betrag angibt, den die Kurve zwischen Kontrollpunkten umkrümmt. 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 er erforderlich ist. 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.