Idioma

GraphicsPath.AddCurve Método

Definição

Adiciona uma curva spline ao valor atual. Uma curva spline cardinal é usada porque a curva passa por cada um dos pontos do arranjo.

Sobrecargas

Nome Descrição
AddCurve(ReadOnlySpan<Point>, Single)

Adiciona uma curva spline ao valor atual.

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

Adiciona uma curva spline ao valor atual.

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

Adiciona uma curva spline ao valor atual.

AddCurve(ReadOnlySpan<PointF>, Single)

Adiciona uma curva spline ao valor atual.

AddCurve(PointF[], Single)

Adiciona uma curva spline ao valor atual.

AddCurve(Point[])

Adiciona uma curva spline ao valor atual. Uma curva spline cardinal é usada porque a curva passa por cada um dos pontos do arranjo.

AddCurve(ReadOnlySpan<PointF>)

Adiciona uma curva spline ao valor atual.

AddCurve(ReadOnlySpan<Point>)

Adiciona uma curva spline ao valor atual.

AddCurve(PointF[])

Adiciona uma curva spline ao valor atual. Uma curva spline cardinal é usada porque a curva passa por cada um dos pontos do arranjo.

AddCurve(Point[], Single)

Adiciona uma curva spline ao valor atual.

AddCurve(ReadOnlySpan<Point>, Single)

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

Adiciona uma curva spline ao valor atual.

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

points
ReadOnlySpan<Point>

Um array de PointF estruturas que representa os pontos que definem a curva.

tension
Single

Um valor que especifica a quantidade que a curva curva entre os pontos de controlo. Valores superiores a 1 produzem resultados imprevisíveis.

Aplica-se a

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

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

Adiciona uma curva spline ao valor 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[]

Um array de PointF estruturas que representa os pontos que definem a curva.

offset
Int32

O índice do elemento no points array que é usado como primeiro ponto na curva.

numberOfSegments
Int32

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

tension
Single

Um valor que especifica a quantidade que a curva curva entre os pontos de controlo. Valores superiores a 1 produzem resultados imprevisíveis.

Exemplos

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

Observações

O utilizador deve manter os pontos originais se forem necessários. Os pontos originais são convertidos internamente em pontos cúbicos de controlo de Bézier, pelo que não existe mecanismo para devolver os pontos originais.

A curva começa no ponto do array especificado por offset, e inclui o número de pontos (segmentos) especificados 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
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs
Origem:
GraphicsPath.cs

Adiciona uma curva spline ao valor 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[]

Um array de Point estruturas que representa os pontos que definem a curva.

offset
Int32

O índice do elemento no points array que é usado como primeiro ponto na curva.

numberOfSegments
Int32

Um valor que especifica a quantidade que a curva curva entre os pontos de controlo. Valores superiores a 1 produzem resultados imprevisíveis.

tension
Single

Um valor que especifica a quantidade que a curva curva entre os pontos de controlo. Valores superiores a 1 produzem resultados imprevisíveis.

Exemplos

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

  • Cria um array de quatro pontos (representando uma spline cardinal).

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

  • Desenha o caminho até ao ecrã.

Note que, embora o array contenha quatro pontos, existem 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

Observações

O utilizador deve manter os pontos originais se forem necessários. Os pontos originais são convertidos internamente em pontos cúbicos de controlo de Bézier, pelo que não existe mecanismo para devolver os pontos originais.

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

Aplica-se a

AddCurve(ReadOnlySpan<PointF>, Single)

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

Adiciona uma curva spline ao valor atual.

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

points
ReadOnlySpan<PointF>

Um array de PointF estruturas que representa os pontos que definem a curva.

tension
Single

Um valor que especifica a quantidade que a curva curva entre os pontos de controlo. Valores superiores a 1 produzem resultados imprevisíveis.

Aplica-se a

AddCurve(PointF[], Single)

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

Adiciona uma curva spline ao valor 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[]

Um array de PointF estruturas que representa os pontos que definem a curva.

tension
Single

Um valor que especifica a quantidade que a curva curva entre os pontos de controlo. Valores superiores a 1 produzem resultados imprevisíveis.

Exemplos

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

Observações

O utilizador deve manter os pontos originais se forem necessários. Os pontos originais são convertidos internamente em pontos cúbicos de controlo de Bézier, pelo que não existe mecanismo para devolver os pontos originais.

Aplica-se a

AddCurve(Point[])

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

Adiciona uma curva spline ao valor atual. Uma curva spline cardinal é usada porque a curva passa por cada um dos pontos do arranjo.

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

Parâmetros

points
Point[]

Um array de Point estruturas que representa os pontos que definem a curva.

Exemplos

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

Observações

O utilizador deve manter os pontos originais se forem necessários. Os pontos originais são convertidos internamente em pontos cúbicos de controlo de Bézier, pelo que não existe mecanismo para devolver os pontos originais.

Aplica-se a

AddCurve(ReadOnlySpan<PointF>)

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

Adiciona uma curva spline ao valor atual.

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

points
ReadOnlySpan<PointF>

Um array de PointF estruturas que representa os pontos que definem a curva.

Aplica-se a

AddCurve(ReadOnlySpan<Point>)

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

Adiciona uma curva spline ao valor atual.

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

points
ReadOnlySpan<Point>

Um array de PointF estruturas que representa os pontos que definem a curva.

Aplica-se a

AddCurve(PointF[])

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

Adiciona uma curva spline ao valor atual. Uma curva spline cardinal é usada porque a curva passa por cada um dos pontos do arranjo.

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

Parâmetros

points
PointF[]

Um array de PointF estruturas que representa os pontos que definem a curva.

Exemplos

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

Observações

O utilizador deve manter os pontos originais se forem necessários. Os pontos originais são convertidos internamente em pontos cúbicos de controlo de Bézier, pelo que não existe mecanismo para devolver os pontos originais.

Aplica-se a

AddCurve(Point[], Single)

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

Adiciona uma curva spline ao valor 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[]

Um array de Point estruturas que representa os pontos que definem a curva.

tension
Single

Um valor que especifica a quantidade que a curva curva entre os pontos de controlo. Valores superiores a 1 produzem resultados imprevisíveis.

Exemplos

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

Observações

O utilizador deve manter os pontos originais se forem necessários. Os pontos originais são convertidos internamente em pontos cúbicos de controlo de Bézier, pelo que não existe mecanismo para devolver os pontos originais.

Aplica-se a