Compartilhar via


GraphicsPath.AddClosedCurve Método

Definição

Adiciona uma curva fechada a esse caminho. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos na matriz.

Sobrecargas

AddClosedCurve(Point[])

Adiciona uma curva fechada a esse caminho. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos na matriz.

AddClosedCurve(PointF[])

Adiciona uma curva fechada a esse caminho. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos na matriz.

AddClosedCurve(ReadOnlySpan<Point>)
AddClosedCurve(ReadOnlySpan<PointF>)
AddClosedCurve(Point[], Single)

Adiciona uma curva fechada a esse caminho. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos na matriz.

AddClosedCurve(PointF[], Single)

Adiciona uma curva fechada a esse caminho. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos na matriz.

AddClosedCurve(ReadOnlySpan<Point>, Single)
AddClosedCurve(ReadOnlySpan<PointF>, Single)

AddClosedCurve(Point[])

Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs

Adiciona uma curva fechada a esse caminho. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos na matriz.

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

Parâmetros

points
Point[]

Uma matriz de estruturas Point que representa os pontos que definem a curva.

Exemplos

Para obter um exemplo, consulte AddClosedCurve(Point[], Single).

Comentários

O usuário deve manter os pontos originais se necessário. Os pontos originais são convertidos em pontos de controle Bézier cúbicos internamente, portanto, não há mecanismo para retornar os pontos originais. Se o primeiro ponto e o último ponto na matriz points não forem o mesmo ponto, a curva será fechada conectando esses dois pontos. O valor de tensão não pode ser definido para esse método e usa como padrão um valor equivalente a 0,5.

Aplica-se a

AddClosedCurve(PointF[])

Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs

Adiciona uma curva fechada a esse caminho. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos na matriz.

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

Parâmetros

points
PointF[]

Uma matriz de estruturas PointF que representa os pontos que definem a curva.

Exemplos

Para obter um exemplo, consulte AddClosedCurve(Point[], Single).

Comentários

O usuário deve manter os pontos originais se necessário. Os pontos originais são convertidos em pontos de controle Bézier cúbicos internamente, portanto, não há mecanismo para retornar os pontos originais. Se o primeiro ponto e o último ponto na matriz points não forem o mesmo ponto, a curva será fechada conectando esses dois pontos. O valor de tensão não pode ser definido para esse método e usa como padrão um valor equivalente a 0,5.

Aplica-se a

AddClosedCurve(ReadOnlySpan<Point>)

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

Parâmetros

Aplica-se a

AddClosedCurve(ReadOnlySpan<PointF>)

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

Parâmetros

Aplica-se a

AddClosedCurve(Point[], Single)

Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs

Adiciona uma curva fechada a esse caminho. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos na matriz.

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[]

Uma matriz de estruturas Point que representa os pontos que definem a curva.

tension
Single

Um valor entre 0 e 1 que especifica a quantidade que a curva dobra entre pontos, sendo 0 a menor curva (canto mais afiado) e 1 sendo a curva mais suave.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, um objeto de evento OnPaint. O código executa as seguintes ações:

  • Cria uma matriz de seis pontos (representando uma spline cardinal).

  • Cria um caminho e adiciona as curvas de spline cardinal fechadas ao caminho (fechado do ponto de extremidade ao ponto de partida).

  • Desenha o caminho para a tela.

Observe que uma tensão de 0,5 é usada.

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 symmetrical, 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 symmetrical, 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

Comentários

O usuário deve manter os pontos originais se necessário. Os pontos originais são convertidos em pontos de controle Bézier cúbicos internamente, portanto, não há mecanismo para retornar os pontos originais. Se o primeiro ponto e o último ponto na matriz points não forem o mesmo ponto, a curva será fechada conectando esses dois pontos.

Aplica-se a

AddClosedCurve(PointF[], Single)

Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs

Adiciona uma curva fechada a esse caminho. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos na matriz.

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[]

Uma matriz de estruturas PointF que representa os pontos que definem a curva.

tension
Single

Um valor entre 0 e 1 que especifica a quantidade que a curva dobra entre pontos, sendo 0 a menor curva (canto mais afiado) e 1 sendo a curva mais suave.

Exemplos

Para obter um exemplo, consulte AddClosedCurve(Point[], Single).

Comentários

O usuário deve manter os pontos originais se necessário. Os pontos originais são convertidos em pontos de controle Bézier cúbicos internamente, portanto, não há mecanismo para retornar os pontos originais. Se o primeiro ponto e o último ponto na matriz points não forem o mesmo ponto, a curva será fechada conectando esses dois pontos.

Aplica-se a

AddClosedCurve(ReadOnlySpan<Point>, Single)

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

Parâmetros

tension
Single

Aplica-se a

AddClosedCurve(ReadOnlySpan<PointF>, Single)

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

Parâmetros

tension
Single

Aplica-se a