GraphicsPath.AddCurve Método

Definición

Espacio de nombres:

System.Drawing.Drawing2D

Ensamblado:

System.Drawing.Common.dll

Paquete:

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

Agrega una curva spline a la ilustración actual. Se usa una curva spline cardinal porque la curva viaja por cada uno de los puntos de la matriz.

Sobrecargas

AddCurve(PointF[], Int32, Int32, Single)	Agrega una curva spline a la ilustración actual.
AddCurve(Point[], Int32, Int32, Single)	Agrega una curva spline a la ilustración actual.
AddCurve(PointF[], Single)	Agrega una curva spline a la ilustración actual.
AddCurve(Point[])	Agrega una curva spline a la ilustración actual. Se usa una curva spline cardinal porque la curva viaja por cada uno de los puntos de la matriz.
AddCurve(PointF[])	Agrega una curva spline a la ilustración actual. Se usa una curva spline cardinal porque la curva viaja por cada uno de los puntos de la matriz.
AddCurve(Point[], Single)	Agrega una curva spline a la ilustración actual.

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

Source:

GraphicsPath.cs

Agrega una curva spline a la ilustración actual.

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)

Parámetros

points

PointF[]

Matriz de estructuras PointF que representa los puntos que definen la curva.

offset

Int32

Índice del elemento de la matriz points que se usa como primer punto de la curva.

numberOfSegments

Int32

Número de segmentos usados para dibujar la curva. Un segmento se puede considerar como una línea que conecta dos puntos.

tension

Single

Valor que especifica la cantidad en la que se dobla la curva entre puntos de control. Los valores mayores que 1 generan resultados imprevisibles.

Ejemplos

Para obtener un ejemplo, vea AddCurve(Point[], Int32, Int32, Single).

Comentarios

El usuario debe mantener los puntos originales si son necesarios. Los puntos originales se convierten a puntos de control bézier cúbicos internamente, por lo que no hay ningún mecanismo para devolver los puntos originales.

La curva comienza en el punto de la matriz especificada por offsete incluye el número de puntos (segmentos) especificados por numberOfSegments.

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

Source:

GraphicsPath.cs

Agrega una curva spline a la ilustración actual.

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)

Parámetros

points

Point[]

Matriz de estructuras Point que representa los puntos que definen la curva.

offset

Int32

Índice del elemento de la matriz points que se usa como primer punto de la curva.

numberOfSegments

Int32

Valor que especifica la cantidad en la que se dobla la curva entre puntos de control. Los valores mayores que 1 generan resultados imprevisibles.

tension

Single

Valor que especifica la cantidad en la que se dobla la curva entre puntos de control. Los valores mayores que 1 generan resultados imprevisibles.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, un objeto de evento OnPaint. El código realiza las siguientes acciones:

• Crea una matriz de cuatro puntos (que representa una spline cardinal).

• Crea una ruta de acceso y usa la matriz de puntos, agrega la curva a la ruta de acceso.

• Dibuja la ruta de acceso a la pantalla.

Observe que, aunque la matriz contiene cuatro puntos, solo hay tres segmentos, que es el número especificado en el tercer argumento de la llamada 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

Comentarios

El usuario debe mantener los puntos originales si son necesarios. Los puntos originales se convierten a puntos de control bézier cúbicos internamente, por lo que no hay ningún mecanismo para devolver los puntos originales.

La curva comienza en el punto de la matriz especificada por el parámetro offset e incluye el número de puntos (segmentos) especificados por numberOfSegments.

AddCurve(PointF[], Single)

Source:

GraphicsPath.cs

Agrega una curva spline a la ilustración actual.

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)

Parámetros

points

PointF[]

Matriz de estructuras PointF que representa los puntos que definen la curva.

tension

Single

Valor que especifica la cantidad en la que se dobla la curva entre puntos de control. Los valores mayores que 1 generan resultados imprevisibles.

Ejemplos

Para obtener un ejemplo, vea AddCurve(Point[], Int32, Int32, Single).

Comentarios

El usuario debe mantener los puntos originales si son necesarios. Los puntos originales se convierten a puntos de control bézier cúbicos internamente, por lo que no hay ningún mecanismo para devolver los puntos originales.

AddCurve(Point[])

Source:

GraphicsPath.cs

Agrega una curva spline a la ilustración actual. Se usa una curva spline cardinal porque la curva viaja por cada uno de los puntos de la matriz.

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

Parámetros

points

Point[]

Matriz de estructuras Point que representa los puntos que definen la curva.

Ejemplos

Para obtener un ejemplo, vea AddClosedCurve(Point[], Single).

Comentarios

El usuario debe mantener los puntos originales si son necesarios. Los puntos originales se convierten a puntos de control bézier cúbicos internamente, por lo que no hay ningún mecanismo para devolver los puntos originales.

AddCurve(PointF[])

Source:

GraphicsPath.cs

Agrega una curva spline a la ilustración actual. Se usa una curva spline cardinal porque la curva viaja por cada uno de los puntos de la matriz.

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

Parámetros

points

PointF[]

Matriz de estructuras PointF que representa los puntos que definen la curva.

Ejemplos

Para obtener un ejemplo, vea AddCurve(Point[], Int32, Int32, Single).

Comentarios

El usuario debe mantener los puntos originales si son necesarios. Los puntos originales se convierten a puntos de control bézier cúbicos internamente, por lo que no hay ningún mecanismo para devolver los puntos originales.

AddCurve(Point[], Single)

Source:

GraphicsPath.cs

Agrega una curva spline a la ilustración actual.

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)

Parámetros

points

Point[]

Matriz de estructuras Point que representa los puntos que definen la curva.

tension

Single

Valor que especifica la cantidad en la que se dobla la curva entre puntos de control. Los valores mayores que 1 generan resultados imprevisibles.

Ejemplos

Para obtener un ejemplo, vea AddClosedCurve(Point[], Single).

Comentarios

El usuario debe mantener los puntos originales si son necesarios. Los puntos originales se convierten a puntos de control bézier cúbicos internamente, por lo que no hay ningún mecanismo para devolver los puntos originales.