Partilhar via


GraphicsPath.AddCurve Método

Definição

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(ReadOnlySpan<Point>, Single)
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(ReadOnlySpan<PointF>, Single)
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(ReadOnlySpan<PointF>)
AddCurve(ReadOnlySpan<Point>)
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(ReadOnlySpan<Point>, Single)

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

Parâmetros

tension
Single

Aplica-se a

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

Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
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.

Aplica-se a

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

Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
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.

Aplica-se a

AddCurve(ReadOnlySpan<PointF>, Single)

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

Parâmetros

tension
Single

Aplica-se a

AddCurve(PointF[], Single)

Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
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.

Aplica-se a

AddCurve(Point[])

Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
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(... cli::array <System::Drawing::Point> ^ points);
public void AddCurve (System.Drawing.Point[] points);
public void AddCurve (params System.Drawing.Point[] points);
member this.AddCurve : System.Drawing.Point[] -> unit
Public Sub AddCurve (points As Point())
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.

Aplica-se a

AddCurve(ReadOnlySpan<PointF>)

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

Parâmetros

Aplica-se a

AddCurve(ReadOnlySpan<Point>)

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

Parâmetros

Aplica-se a

AddCurve(PointF[])

Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
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(... cli::array <System::Drawing::PointF> ^ points);
public void AddCurve (System.Drawing.PointF[] points);
public void AddCurve (params System.Drawing.PointF[] points);
member this.AddCurve : System.Drawing.PointF[] -> unit
Public Sub AddCurve (points As PointF())
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.

Aplica-se a

AddCurve(Point[], Single)

Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
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.

Aplica-se a