GraphicsPath.AddCurve 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 de spline à figura atual. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos na matriz.

Sobrecargas

AddCurve(PointF[], Int32, Int32, Single)	Adiciona uma curva de spline à figura atual.
AddCurve(Point[], Int32, Int32, Single)	Adiciona uma curva de spline à figura atual.
AddCurve(PointF[], Single)	Adiciona uma curva de spline à figura atual.
AddCurve(Point[])	Adiciona uma curva de spline à figura atual. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos na matriz.
AddCurve(PointF[])	Adiciona uma curva de spline à figura atual. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos na matriz.
AddCurve(Point[], Single)	Adiciona uma curva de spline à figura atual.

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

Origem:

GraphicsPath.cs

Adiciona uma curva de spline à figura atual.

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

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

offset

Int32

O índice do elemento na matriz points que é usado como o primeiro ponto na curva.

numberOfSegments

Int32

O número de segmentos usados para desenhar a curva. Um segmento pode ser considerado como uma linha que conecta dois pontos.

tension

Single

Um valor que especifica a quantidade que a curva dobra entre pontos de controle. Valores maiores que 1 produzem resultados imprevisíveis.

Exemplos

Para obter um exemplo, consulte AddCurve(Point[], Int32, Int32, 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.

A curva começa no ponto da matriz especificada por offsete inclui o número de pontos (segmentos) especificado por numberOfSegments.

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

Origem:

GraphicsPath.cs

Adiciona uma curva de spline à figura atual.

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

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

offset

Int32

O índice do elemento na matriz points que é usado como o primeiro ponto na curva.

numberOfSegments

Int32

Um valor que especifica a quantidade que a curva dobra entre pontos de controle. Valores maiores que 1 produzem resultados imprevisíveis.

tension

Single

Um valor que especifica a quantidade que a curva dobra entre pontos de controle. Valores maiores que 1 produzem resultados imprevisíveis.

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 quatro pontos (representando uma spline cardinal).

• Cria um caminho e, usando a matriz de pontos, adiciona a curva ao caminho.

• Desenha o caminho para a tela.

Observe que, embora a matriz contenha quatro pontos, há apenas três segmentos, que é o número especificado no terceiro argumento da chamada para 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

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.

A curva começa no ponto da matriz especificada pelo parâmetro offset e inclui o número de pontos (segmentos) especificado por numberOfSegments.

AddCurve(PointF[], Single)

Origem:

GraphicsPath.cs

Adiciona uma curva de spline à figura atual.

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

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

tension

Single

Um valor que especifica a quantidade que a curva dobra entre pontos de controle. Valores maiores que 1 produzem resultados imprevisíveis.

Exemplos

Para obter um exemplo, consulte AddCurve(Point[], Int32, Int32, 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.

AddCurve(Point[])

Origem:

GraphicsPath.cs

Adiciona uma curva de spline à figura atual. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos na 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[]

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.

AddCurve(PointF[])

Origem:

GraphicsPath.cs

Adiciona uma curva de spline à figura atual. Uma curva de spline cardinal é usada porque a curva percorre cada um dos pontos na 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[]

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

Exemplos

Para obter um exemplo, consulte AddCurve(Point[], Int32, Int32, 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.

AddCurve(Point[], Single)

Origem:

GraphicsPath.cs

Adiciona uma curva de spline à figura atual.

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

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

tension

Single

Um valor que especifica a quantidade que a curva dobra entre pontos de controle. Valores maiores que 1 produzem resultados imprevisíveis.

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.