Freigeben über


GraphicsPath.AddCurve Methode

Definition

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(ReadOnlySpan<Point>, Single)
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(ReadOnlySpan<PointF>, Single)
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(ReadOnlySpan<PointF>)
AddCurve(ReadOnlySpan<Point>)
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(ReadOnlySpan<Point>, Single)

Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
public:
 void AddCurve(ReadOnlySpan<System::Drawing::Point> points, float tension);
public void AddCurve (ReadOnlySpan<System.Drawing.Point> points, float tension);
member this.AddCurve : ReadOnlySpan<System.Drawing.Point> * single -> unit
Public Sub AddCurve (points As ReadOnlySpan(Of Point), tension As Single)

Parameter

tension
Single

Gilt für:

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

Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
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.

Gilt für:

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

Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
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.

Gilt für:

AddCurve(ReadOnlySpan<PointF>, Single)

Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
public:
 void AddCurve(ReadOnlySpan<System::Drawing::PointF> points, float tension);
public void AddCurve (ReadOnlySpan<System.Drawing.PointF> points, float tension);
member this.AddCurve : ReadOnlySpan<System.Drawing.PointF> * single -> unit
Public Sub AddCurve (points As ReadOnlySpan(Of PointF), tension As Single)

Parameter

tension
Single

Gilt für:

AddCurve(PointF[], Single)

Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
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.

Gilt für:

AddCurve(Point[])

Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
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(... cli::array <System::Drawing::Point> ^ points);
public void AddCurve (System.Drawing.Point[] points);
public void AddCurve (params System.Drawing.Point[] points);
member this.AddCurve : System.Drawing.Point[] -> unit
Public Sub AddCurve (points As Point())
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.

Gilt für:

AddCurve(ReadOnlySpan<PointF>)

Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
public:
 void AddCurve(ReadOnlySpan<System::Drawing::PointF> points);
public void AddCurve (scoped ReadOnlySpan<System.Drawing.PointF> points);
member this.AddCurve : ReadOnlySpan<System.Drawing.PointF> -> unit
Public Sub AddCurve (points As ReadOnlySpan(Of PointF))

Parameter

Gilt für:

AddCurve(ReadOnlySpan<Point>)

Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
public:
 void AddCurve(ReadOnlySpan<System::Drawing::Point> points);
public void AddCurve (ReadOnlySpan<System.Drawing.Point> points);
member this.AddCurve : ReadOnlySpan<System.Drawing.Point> -> unit
Public Sub AddCurve (points As ReadOnlySpan(Of Point))

Parameter

Gilt für:

AddCurve(PointF[])

Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
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(... cli::array <System::Drawing::PointF> ^ points);
public void AddCurve (System.Drawing.PointF[] points);
public void AddCurve (params System.Drawing.PointF[] points);
member this.AddCurve : System.Drawing.PointF[] -> unit
Public Sub AddCurve (points As PointF())
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.

Gilt für:

AddCurve(Point[], Single)

Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
Quelle:
GraphicsPath.cs
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.

Gilt für: