GraphicsPath.AddClosedCurve Método

Definição

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Pacote:

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

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(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(Point[])

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 (params System.Drawing.Point[] points);

member this.AddClosedCurve : System.Drawing.Point[] -> unit

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.

AddClosedCurve(PointF[])

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 (params System.Drawing.PointF[] points);

member this.AddClosedCurve : System.Drawing.PointF[] -> unit

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.

AddClosedCurve(Point[], Single)

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.

AddClosedCurve(PointF[], Single)

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.