GraphicsPath.AddCurve Méthode

Définition

Espace de noms:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paquet:

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

Ajoute une courbe spline à la figure actuelle. Une courbe de spline cardinale est utilisée, car la courbe se déplace à travers chacun des points du tableau.

Surcharges

AddCurve(PointF[], Int32, Int32, Single)	Ajoute une courbe spline à la figure actuelle.
AddCurve(Point[], Int32, Int32, Single)	Ajoute une courbe spline à la figure actuelle.
AddCurve(PointF[], Single)	Ajoute une courbe spline à la figure actuelle.
AddCurve(Point[])	Ajoute une courbe spline à la figure actuelle. Une courbe de spline cardinale est utilisée, car la courbe se déplace à travers chacun des points du tableau.
AddCurve(PointF[])	Ajoute une courbe spline à la figure actuelle. Une courbe de spline cardinale est utilisée, car la courbe se déplace à travers chacun des points du tableau.
AddCurve(Point[], Single)	Ajoute une courbe spline à la figure actuelle.

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

Source:

GraphicsPath.cs

Ajoute une courbe spline à la figure actuelle.

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)

Paramètres

points

PointF[]

Tableau de structures PointF qui représente les points qui définissent la courbe.

offset

Int32

Index de l’élément dans le tableau points utilisé comme premier point de la courbe.

numberOfSegments

Int32

Nombre de segments utilisés pour dessiner la courbe. Un segment peut être considéré comme une ligne reliant deux points.

tension

Single

Valeur qui spécifie la quantité que la courbe plie entre les points de contrôle. Les valeurs supérieures à 1 produisent des résultats imprévisibles.

Exemples

Pour obtenir un exemple, consultez AddCurve(Point[], Int32, Int32, Single).

Remarques

L’utilisateur doit conserver les points d’origine s’il en a besoin. Les points d’origine sont convertis en points de contrôle de Bézier cubes en interne, il n’existe donc aucun mécanisme pour retourner les points d’origine.

La courbe commence au point dans le tableau spécifié par offsetet inclut le nombre de points (segments) spécifiés par numberOfSegments.

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

Source:

GraphicsPath.cs

Ajoute une courbe spline à la figure actuelle.

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)

Paramètres

points

Point[]

Tableau de structures Point qui représente les points qui définissent la courbe.

offset

Int32

Index de l’élément dans le tableau points utilisé comme premier point de la courbe.

numberOfSegments

Int32

Valeur qui spécifie la quantité que la courbe plie entre les points de contrôle. Les valeurs supérieures à 1 produisent des résultats imprévisibles.

tension

Single

Valeur qui spécifie la quantité que la courbe plie entre les points de contrôle. Les valeurs supérieures à 1 produisent des résultats imprévisibles.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, un objet d’événement OnPaint. Le code effectue les actions suivantes :

• Crée un tableau de quatre points (représentant une spline cardinale).

• Crée un chemin et utilise le tableau de points, ajoute la courbe au chemin.

• Dessine le chemin d’accès à l’écran.

Notez que si le tableau contient quatre points, il n’y a que trois segments, qui est le nombre spécifié dans le troisième argument de l’appel à 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

Remarques

L’utilisateur doit conserver les points d’origine s’il en a besoin. Les points d’origine sont convertis en points de contrôle de Bézier cubes en interne, il n’existe donc aucun mécanisme pour retourner les points d’origine.

La courbe commence au point dans le tableau spécifié par le paramètre offset et inclut le nombre de points (segments) spécifiés par numberOfSegments.

AddCurve(PointF[], Single)

Source:

GraphicsPath.cs

Ajoute une courbe spline à la figure actuelle.

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)

Paramètres

points

PointF[]

Tableau de structures PointF qui représente les points qui définissent la courbe.

tension

Single

Valeur qui spécifie la quantité que la courbe plie entre les points de contrôle. Les valeurs supérieures à 1 produisent des résultats imprévisibles.

Exemples

Pour obtenir un exemple, consultez AddCurve(Point[], Int32, Int32, Single).

Remarques

L’utilisateur doit conserver les points d’origine s’il en a besoin. Les points d’origine sont convertis en points de contrôle de Bézier cubes en interne, il n’existe donc aucun mécanisme pour retourner les points d’origine.

AddCurve(Point[])

Source:

GraphicsPath.cs

Ajoute une courbe spline à la figure actuelle. Une courbe de spline cardinale est utilisée, car la courbe se déplace à travers chacun des points du tableau.

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

Paramètres

points

Point[]

Tableau de structures Point qui représente les points qui définissent la courbe.

Exemples

Pour obtenir un exemple, consultez AddClosedCurve(Point[], Single).

Remarques

L’utilisateur doit conserver les points d’origine s’il en a besoin. Les points d’origine sont convertis en points de contrôle de Bézier cubes en interne, il n’existe donc aucun mécanisme pour retourner les points d’origine.

AddCurve(PointF[])

Source:

GraphicsPath.cs

Ajoute une courbe spline à la figure actuelle. Une courbe de spline cardinale est utilisée, car la courbe se déplace à travers chacun des points du tableau.

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

Paramètres

points

PointF[]

Tableau de structures PointF qui représente les points qui définissent la courbe.

Exemples

Pour obtenir un exemple, consultez AddCurve(Point[], Int32, Int32, Single).

Remarques

L’utilisateur doit conserver les points d’origine s’il en a besoin. Les points d’origine sont convertis en points de contrôle de Bézier cubes en interne, il n’existe donc aucun mécanisme pour retourner les points d’origine.

AddCurve(Point[], Single)

Source:

GraphicsPath.cs

Ajoute une courbe spline à la figure actuelle.

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)

Paramètres

points

Point[]

Tableau de structures Point qui représente les points qui définissent la courbe.

tension

Single

Valeur qui spécifie la quantité que la courbe plie entre les points de contrôle. Les valeurs supérieures à 1 produisent des résultats imprévisibles.

Exemples

Pour obtenir un exemple, consultez AddClosedCurve(Point[], Single).

Remarques

L’utilisateur doit conserver les points d’origine s’il en a besoin. Les points d’origine sont convertis en points de contrôle de Bézier cubes en interne, il n’existe donc aucun mécanisme pour retourner les points d’origine.