GraphicsPath.AddCurve Metodo

Definizione

Spazio dei nomi:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Pacchetto:

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

Aggiunge una curva spline alla figura corrente. Viene usata una curva spline cardinale perché la curva attraversa ognuno dei punti della matrice.

Overload

AddCurve(PointF[], Int32, Int32, Single)	Aggiunge una curva spline alla figura corrente.
AddCurve(Point[], Int32, Int32, Single)	Aggiunge una curva spline alla figura corrente.
AddCurve(PointF[], Single)	Aggiunge una curva spline alla figura corrente.
AddCurve(Point[])	Aggiunge una curva spline alla figura corrente. Viene usata una curva spline cardinale perché la curva attraversa ognuno dei punti della matrice.
AddCurve(PointF[])	Aggiunge una curva spline alla figura corrente. Viene usata una curva spline cardinale perché la curva attraversa ognuno dei punti della matrice.
AddCurve(Point[], Single)	Aggiunge una curva spline alla figura corrente.

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

Origine:

GraphicsPath.cs

Aggiunge una curva spline alla figura corrente.

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)

Parametri

points

PointF[]

Matrice di strutture PointF che rappresenta i punti che definiscono la curva.

offset

Int32

Indice dell'elemento nella matrice points utilizzata come primo punto della curva.

numberOfSegments

Int32

Numero di segmenti utilizzati per disegnare la curva. Un segmento può essere considerato come una linea che collega due punti.

tension

Single

Valore che specifica la quantità che la curva piega tra i punti di controllo. I valori maggiori di 1 producono risultati imprevedibili.

Esempio

Per un esempio, vedere AddCurve(Point[], Int32, Int32, Single).

Commenti

Se necessario, l'utente deve mantenere i punti originali. I punti originali vengono convertiti internamente in punti di controllo Bézier cubici, pertanto non esiste alcun meccanismo per restituire i punti originali.

La curva inizia nel punto della matrice specificata da offsete include il numero di punti (segmenti) specificati da numberOfSegments.

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

Origine:

GraphicsPath.cs

Aggiunge una curva spline alla figura corrente.

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)

Parametri

points

Point[]

Matrice di strutture Point che rappresenta i punti che definiscono la curva.

offset

Int32

Indice dell'elemento nella matrice points utilizzata come primo punto della curva.

numberOfSegments

Int32

Valore che specifica la quantità che la curva piega tra i punti di controllo. I valori maggiori di 1 producono risultati imprevedibili.

tension

Single

Valore che specifica la quantità che la curva piega tra i punti di controllo. I valori maggiori di 1 producono risultati imprevedibili.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, un oggetto evento OnPaint. Il codice esegue le azioni seguenti:

• Crea una matrice di quattro punti (che rappresenta una spline cardinale).

• Crea un percorso e usando la matrice di punti, aggiunge la curva al percorso.

• Disegna il percorso dello schermo.

Si noti che mentre la matrice contiene quattro punti, sono presenti solo tre segmenti, ovvero il numero specificato nel terzo argomento della chiamata a AddCurve.

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

Commenti

Se necessario, l'utente deve mantenere i punti originali. I punti originali vengono convertiti internamente in punti di controllo Bézier cubici, pertanto non esiste alcun meccanismo per restituire i punti originali.

La curva inizia in corrispondenza del punto della matrice specificata dal parametro offset e include il numero di punti (segmenti) specificati da numberOfSegments.

AddCurve(PointF[], Single)

Origine:

GraphicsPath.cs

Aggiunge una curva spline alla figura corrente.

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)

Parametri

points

PointF[]

Matrice di strutture PointF che rappresenta i punti che definiscono la curva.

tension

Single

Valore che specifica la quantità che la curva piega tra i punti di controllo. I valori maggiori di 1 producono risultati imprevedibili.

Esempio

Per un esempio, vedere AddCurve(Point[], Int32, Int32, Single).

Commenti

Se necessario, l'utente deve mantenere i punti originali. I punti originali vengono convertiti internamente in punti di controllo Bézier cubici, pertanto non esiste alcun meccanismo per restituire i punti originali.

AddCurve(Point[])

Origine:

GraphicsPath.cs

Aggiunge una curva spline alla figura corrente. Viene usata una curva spline cardinale perché la curva attraversa ognuno dei punti della matrice.

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

Parametri

points

Point[]

Matrice di strutture Point che rappresenta i punti che definiscono la curva.

Esempio

Per un esempio, vedere AddClosedCurve(Point[], Single).

Commenti

Se necessario, l'utente deve mantenere i punti originali. I punti originali vengono convertiti internamente in punti di controllo Bézier cubici, pertanto non esiste alcun meccanismo per restituire i punti originali.

AddCurve(PointF[])

Origine:

GraphicsPath.cs

Aggiunge una curva spline alla figura corrente. Viene usata una curva spline cardinale perché la curva attraversa ognuno dei punti della matrice.

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

Parametri

points

PointF[]

Matrice di strutture PointF che rappresenta i punti che definiscono la curva.

Esempio

Per un esempio, vedere AddCurve(Point[], Int32, Int32, Single).

Commenti

Se necessario, l'utente deve mantenere i punti originali. I punti originali vengono convertiti internamente in punti di controllo Bézier cubici, pertanto non esiste alcun meccanismo per restituire i punti originali.

AddCurve(Point[], Single)

Origine:

GraphicsPath.cs

Aggiunge una curva spline alla figura corrente.

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)

Parametri

points

Point[]

Matrice di strutture Point che rappresenta i punti che definiscono la curva.

tension

Single

Valore che specifica la quantità che la curva piega tra i punti di controllo. I valori maggiori di 1 producono risultati imprevedibili.

Esempio

Per un esempio, vedere AddClosedCurve(Point[], Single).

Commenti

Se necessario, l'utente deve mantenere i punti originali. I punti originali vengono convertiti internamente in punti di controllo Bézier cubici, pertanto non esiste alcun meccanismo per restituire i punti originali.