GraphicsPath.AddClosedCurve Método

Definición

Agrega una curva cerrada a este trazado.Adds a closed curve to this path. Se utiliza una curva spline cardinal porque la curva recorre todos los puntos de la matriz.A cardinal spline curve is used because the curve travels through each of the points in the array.

Sobrecargas

AddClosedCurve(Point[])

Agrega una curva cerrada a este trazado.Adds a closed curve to this path. Se utiliza una curva spline cardinal porque la curva recorre todos los puntos de la matriz.A cardinal spline curve is used because the curve travels through each of the points in the array.

AddClosedCurve(PointF[])

Agrega una curva cerrada a este trazado.Adds a closed curve to this path. Se utiliza una curva spline cardinal porque la curva recorre todos los puntos de la matriz.A cardinal spline curve is used because the curve travels through each of the points in the array.

AddClosedCurve(Point[], Single)

Agrega una curva cerrada a este trazado.Adds a closed curve to this path. Se utiliza una curva spline cardinal porque la curva recorre todos los puntos de la matriz.A cardinal spline curve is used because the curve travels through each of the points in the array.

AddClosedCurve(PointF[], Single)

Agrega una curva cerrada a este trazado.Adds a closed curve to this path. Se utiliza una curva spline cardinal porque la curva recorre todos los puntos de la matriz.A cardinal spline curve is used because the curve travels through each of the points in the array.

AddClosedCurve(Point[])

Agrega una curva cerrada a este trazado.Adds a closed curve to this path. Se utiliza una curva spline cardinal porque la curva recorre todos los puntos de la matriz.A cardinal spline curve is used because the curve travels through each of the points in the array.

public:
 void AddClosedCurve(cli::array <System::Drawing::Point> ^ points);
public void AddClosedCurve (System.Drawing.Point[] points);
member this.AddClosedCurve : System.Drawing.Point[] -> unit
Public Sub AddClosedCurve (points As Point())

Parámetros

points
Point[]

Matriz de estructuras Point que representa los puntos que definen la curva.An array of Point structures that represents the points that define the curve.

Ejemplos

Para obtener un ejemplo, vea AddClosedCurve(Point[], Single).For an example, see AddClosedCurve(Point[], Single).

Comentarios

El usuario debe conservar los puntos originales si es necesario.The user must keep the original points if they are needed. Los puntos originales se convierten en puntos de control Bézier cúbicos internamente, por lo que no hay ningún mecanismo para devolver los puntos originales.The original points are converted to cubic Bézier control points internally, therefore there is no mechanism for returning the original points. Si el primer punto y el último punto de la matriz points no son el mismo punto, la curva se cierra conectando estos dos puntos.If the first point and the last point in the points array are not the same point, the curve is closed by connecting these two points. No se puede establecer el valor de tensión para este método y su valor predeterminado es equivalente a 0,5.The tension value cannot be set for this method, and defaults to a value equivalent to 0.5.

AddClosedCurve(PointF[])

Agrega una curva cerrada a este trazado.Adds a closed curve to this path. Se utiliza una curva spline cardinal porque la curva recorre todos los puntos de la matriz.A cardinal spline curve is used because the curve travels through each of the points in the array.

public:
 void AddClosedCurve(cli::array <System::Drawing::PointF> ^ points);
public void AddClosedCurve (System.Drawing.PointF[] points);
member this.AddClosedCurve : System.Drawing.PointF[] -> unit
Public Sub AddClosedCurve (points As PointF())

Parámetros

points
PointF[]

Matriz de estructuras PointF que representa los puntos que definen la curva.An array of PointF structures that represents the points that define the curve.

Ejemplos

Para obtener un ejemplo, vea AddClosedCurve(Point[], Single).For an example, see AddClosedCurve(Point[], Single).

Comentarios

El usuario debe conservar los puntos originales si es necesario.The user must keep the original points if they are needed. Los puntos originales se convierten en puntos de control Bézier cúbicos internamente, por lo que no hay ningún mecanismo para devolver los puntos originales.The original points are converted to cubic Bézier control points internally, therefore there is no mechanism for returning the original points. Si el primer punto y el último punto de la matriz points no son el mismo punto, la curva se cierra conectando estos dos puntos.If the first point and the last point in the points array are not the same point, the curve is closed by connecting these two points. No se puede establecer el valor de tensión para este método y su valor predeterminado es equivalente a 0,5.The tension value cannot be set for this method, and defaults to a value equivalent to 0.5.

AddClosedCurve(Point[], Single)

Agrega una curva cerrada a este trazado.Adds a closed curve to this path. Se utiliza una curva spline cardinal porque la curva recorre todos los puntos de la matriz.A cardinal spline curve is used because the curve travels through each of the points in the array.

public:
 void AddClosedCurve(cli::array <System::Drawing::Point> ^ points, float tension);
public void AddClosedCurve (System.Drawing.Point[] points, float tension);
member this.AddClosedCurve : System.Drawing.Point[] * single -> unit
Public Sub AddClosedCurve (points As Point(), tension As Single)

Parámetros

points
Point[]

Matriz de estructuras Point que representa los puntos que definen la curva.An array of Point structures that represents the points that define the curve.

tension
Single

Valor de 0 a 1 que especifica la inclinación de la curva entre puntos, donde 0 es la curva más cerrada (esquina más apuntada) y 1 es la curva más abierta.A value between from 0 through 1 that specifies the amount that the curve bends between points, with 0 being the smallest curve (sharpest corner) and 1 being the smoothest curve.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgse, un objeto de evento de OnPaint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, an OnPaint event object. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea una matriz de seis puntos (que representa una curva spline cardinal).Creates an array of six points (representing a cardinal spline).

  • Crea una ruta de acceso y agrega las curvas spline cardinal cerradas al trazado (cerrado desde el punto de conexión al punto inicial).Creates a path and adds the closed cardinal spline curves to the path (closed from the endpoint to the starting point).

  • Dibuja la ruta de acceso en la pantalla.Draws the path to screen.

Observe que se usa una tensión de 0,5.Notice that a tension of 0.5 is used.

private:
   void AddClosedCurveExample( PaintEventArgs^ e )
   {
      // Creates a symetrical, closed curve.
      array<Point>^ myArray = {Point(20,100),Point(40,150),Point(60,125),Point(40,100),Point(60,75),Point(40,50)};

      // Create a new path and add curve.
      GraphicsPath^ myPath = gcnew GraphicsPath;
      myPath->AddClosedCurve( myArray, .5f );
      Pen^ myPen = gcnew Pen( Color::Black,2.0f );

      // Draw the path to screen.
      e->Graphics->DrawPath( myPen, myPath );
   }
private void AddClosedCurveExample(PaintEventArgs e)
{
             
    // Creates a symetrical, closed curve.
    Point[] myArray =
             {
                 new Point(20,100),
                 new Point(40,150),
                 new Point(60,125),
                 new Point(40,100),
                 new Point(60,75),
                 new Point(40,50)
             };
             
    // Create a new path and add curve.
    GraphicsPath myPath = new GraphicsPath();
    myPath.AddClosedCurve(myArray,.5f);
    Pen myPen = new Pen(Color.Black, 2);
             
    // Draw the path to screen.
    e.Graphics.DrawPath(myPen, myPath);
}
Public Sub AddClosedCurveExample(ByVal e As PaintEventArgs)

    ' Creates a symetrical, closed curve.
    Dim myArray As Point() = {New Point(20, 100), New Point(40, 150), _
    New Point(60, 125), New Point(40, 100), New Point(60, 75), _
    New Point(40, 50)}
    Dim myPath As New GraphicsPath
    myPath.AddClosedCurve(myArray, 0.5F)
    Dim myPen As New Pen(Color.Black, 2)
    e.Graphics.DrawPath(myPen, myPath)
End Sub

Comentarios

El usuario debe conservar los puntos originales si es necesario.The user must keep the original points if they are needed. Los puntos originales se convierten en puntos de control Bézier cúbicos internamente, por lo que no hay ningún mecanismo para devolver los puntos originales.The original points are converted to cubic Bézier control points internally, therefore there is no mechanism for returning the original points. Si el primer punto y el último punto de la matriz points no son el mismo punto, la curva se cierra conectando estos dos puntos.If the first point and the last point in the points array are not the same point, the curve is closed by connecting these two points.

AddClosedCurve(PointF[], Single)

Agrega una curva cerrada a este trazado.Adds a closed curve to this path. Se utiliza una curva spline cardinal porque la curva recorre todos los puntos de la matriz.A cardinal spline curve is used because the curve travels through each of the points in the array.

public:
 void AddClosedCurve(cli::array <System::Drawing::PointF> ^ points, float tension);
public void AddClosedCurve (System.Drawing.PointF[] points, float tension);
member this.AddClosedCurve : System.Drawing.PointF[] * single -> unit
Public Sub AddClosedCurve (points As PointF(), tension As Single)

Parámetros

points
PointF[]

Matriz de estructuras PointF que representa los puntos que definen la curva.An array of PointF structures that represents the points that define the curve.

tension
Single

Valor de 0 a 1 que especifica la inclinación de la curva entre puntos, donde 0 es la curva más cerrada (esquina más apuntada) y 1 es la curva más abierta.A value between from 0 through 1 that specifies the amount that the curve bends between points, with 0 being the smallest curve (sharpest corner) and 1 being the smoothest curve.

Ejemplos

Para obtener un ejemplo, vea AddClosedCurve(Point[], Single).For an example, see AddClosedCurve(Point[], Single).

Comentarios

El usuario debe conservar los puntos originales si es necesario.The user must keep the original points if they are needed. Los puntos originales se convierten en puntos de control Bézier cúbicos internamente, por lo que no hay ningún mecanismo para devolver los puntos originales.The original points are converted to cubic Bézier control points internally, therefore there is no mechanism for returning the original points. Si el primer punto y el último punto de la matriz points no son el mismo punto, la curva se cierra conectando estos dos puntos.If the first point and the last point in the points array are not the same point, the curve is closed by connecting these two points.

Se aplica a