Graphics.DrawClosedCurve Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

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

Desenha um spline cardinal fechado definido por uma matriz de estruturas de Point.

Sobrecargas

DrawClosedCurve(Pen, PointF[], Single, FillMode)	Desenha uma spline cardinal fechada definida por uma matriz de estruturas de PointF usando uma tensão especificada.
DrawClosedCurve(Pen, Point[], Single, FillMode)	Desenha uma spline cardinal fechada definida por uma matriz de estruturas de Point usando uma tensão especificada.
DrawClosedCurve(Pen, Point[])	Desenha um spline cardinal fechado definido por uma matriz de estruturas de Point.
DrawClosedCurve(Pen, PointF[])	Desenha um spline cardinal fechado definido por uma matriz de estruturas de PointF.

DrawClosedCurve(Pen, PointF[], Single, FillMode)

Origem:

Graphics.cs

Desenha uma spline cardinal fechada definida por uma matriz de estruturas de PointF usando uma tensão especificada.

public:
 void DrawClosedCurve(System::Drawing::Pen ^ pen, cli::array <System::Drawing::PointF> ^ points, float tension, System::Drawing::Drawing2D::FillMode fillmode);

public void DrawClosedCurve (System.Drawing.Pen pen, System.Drawing.PointF[] points, float tension, System.Drawing.Drawing2D.FillMode fillmode);

member this.DrawClosedCurve : System.Drawing.Pen * System.Drawing.PointF[] * single * System.Drawing.Drawing2D.FillMode -> unit

Public Sub DrawClosedCurve (pen As Pen, points As PointF(), tension As Single, fillmode As FillMode)

Parâmetros

pen

Pen

Pen que determina a cor, a largura e a altura da curva.

points

PointF[]

Matriz de estruturas PointF que definem o spline.

tension

Single

Valor maior ou igual a 0,0F que especifica a tensão da curva.

fillmode

FillMode

Membro da enumeração FillMode que determina como a curva é preenchida. Esse parâmetro é necessário, mas é ignorado.

Exceções

ArgumentNullException

pen é null.

-ou-

points é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria canetas vermelhas e verdes.

• Cria sete pontos para definir a curva.

• Desenha sete linhas retas vermelhas entre os sete pontos para formar um polígono.

• Cria configurações de tensão e modo de preenchimento.

• Desenha uma curva fechada verde através dos sete pontos.

O método usa uma tensão de 1.0 e define o modo de preenchimento como FillMode.Alternate.

private:
   void DrawClosedCurvePointFTension( PaintEventArgs^ e )
   {
      // Create pens.
      Pen^ redPen = gcnew Pen( Color::Red,3.0f );
      Pen^ greenPen = gcnew Pen( Color::Green,3.0f );

      // Create points that define curve.
      PointF point1 = PointF(50.0F,50.0F);
      PointF point2 = PointF(100.0F,25.0F);
      PointF point3 = PointF(200.0F,5.0F);
      PointF point4 = PointF(250.0F,50.0F);
      PointF point5 = PointF(300.0F,100.0F);
      PointF point6 = PointF(350.0F,200.0F);
      PointF point7 = PointF(250.0F,250.0F);
      array<PointF>^ curvePoints = {point1,point2,point3,point4,point5,point6,point7};

      // Draw lines between original points to screen.
      e->Graphics->DrawLines( redPen, curvePoints );

      // Create tension and fill mode.
      float tension = 1.0F;
      FillMode aFillMode = FillMode::Alternate;

      // Draw closed curve to screen.
      e->Graphics->DrawClosedCurve( greenPen, curvePoints, tension, aFillMode );
   }

private void DrawClosedCurvePointFTension(PaintEventArgs e)
{

    // Create pens.
    Pen redPen = new Pen(Color.Red, 3);
    Pen greenPen = new Pen(Color.Green, 3);

    // Create points that define curve.
    PointF point1 = new PointF(50.0F, 50.0F);
    PointF point2 = new PointF(100.0F, 25.0F);
    PointF point3 = new PointF(200.0F, 5.0F);
    PointF point4 = new PointF(250.0F, 50.0F);
    PointF point5 = new PointF(300.0F, 100.0F);
    PointF point6 = new PointF(350.0F, 200.0F);
    PointF point7 = new PointF(250.0F, 250.0F);
    PointF[] curvePoints = {point1, point2, point3, point4, point5, point6, point7};

    // Draw lines between original points to screen.
    e.Graphics.DrawLines(redPen, curvePoints);

    // Create tension and fill mode.
    float tension = 1.0F;
    FillMode aFillMode = FillMode.Alternate;

    // Draw closed curve to screen.
    e.Graphics.DrawClosedCurve(greenPen, curvePoints, tension, aFillMode);
}

Private Sub DrawClosedCurvePointFTension(ByVal e As PaintEventArgs)

    ' Create pens.
    Dim redPen As New Pen(Color.Red, 3)
    Dim greenPen As New Pen(Color.Green, 3)

    ' Create points that define curve.
    Dim point1 As New PointF(50.0F, 50.0F)
    Dim point2 As New PointF(100.0F, 25.0F)
    Dim point3 As New PointF(200.0F, 5.0F)
    Dim point4 As New PointF(250.0F, 50.0F)
    Dim point5 As New PointF(300.0F, 100.0F)
    Dim point6 As New PointF(350.0F, 200.0F)
    Dim point7 As New PointF(250.0F, 250.0F)
    Dim curvePoints As PointF() = {point1, point2, point3, point4, _
    point5, point6, point7}

    ' Draw lines between original points to screen.
    e.Graphics.DrawLines(redPen, curvePoints)

    ' Create tension and fill mode.
    Dim tension As Single = 1.0F
    Dim aFillMode As FillMode = FillMode.Alternate

    ' Draw closed curve to screen.
    e.Graphics.DrawClosedCurve(greenPen, curvePoints, tension, _
    aFillMode)
End Sub

Comentários

Esse método desenha um spline cardinal fechado que passa por cada ponto na matriz. Se o último ponto não corresponder ao primeiro ponto, um segmento de curva adicional será adicionado do último ponto ao primeiro ponto para fechá-lo.

A matriz de pontos deve conter pelo menos quatro estruturas PointF.

O parâmetro tension determina a forma do spline. Se o valor do parâmetro tension for 0,0F, esse método desenhará segmentos de linha reta para conectar os pontos. Normalmente, o parâmetro tension é menor ou igual a 1,0F. Valores acima de 1,0F produzem resultados incomuns.

DrawClosedCurve(Pen, Point[], Single, FillMode)

Origem:

Graphics.cs

Desenha uma spline cardinal fechada definida por uma matriz de estruturas de Point usando uma tensão especificada.

public:
 void DrawClosedCurve(System::Drawing::Pen ^ pen, cli::array <System::Drawing::Point> ^ points, float tension, System::Drawing::Drawing2D::FillMode fillmode);

public void DrawClosedCurve (System.Drawing.Pen pen, System.Drawing.Point[] points, float tension, System.Drawing.Drawing2D.FillMode fillmode);

member this.DrawClosedCurve : System.Drawing.Pen * System.Drawing.Point[] * single * System.Drawing.Drawing2D.FillMode -> unit

Public Sub DrawClosedCurve (pen As Pen, points As Point(), tension As Single, fillmode As FillMode)

Parâmetros

pen

Pen

Pen que determina a cor, a largura e a altura da curva.

points

Point[]

Matriz de estruturas Point que definem o spline.

tension

Single

Valor maior ou igual a 0,0F que especifica a tensão da curva.

fillmode

FillMode

Membro da enumeração FillMode que determina como a curva é preenchida. Esse parâmetro é necessário, mas ignorado.

Exceções

ArgumentNullException

pen é null.

-ou-

points é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria canetas vermelhas e verdes.

• Cria sete pontos para definir a curva.

• Desenha sete linhas retas vermelhas entre os sete pontos para formar um polígono.

• Cria configurações de tensão e modo de preenchimento.

• Desenha uma curva fechada verde através dos sete pontos.

O método usa uma tensão de 1.0 e define o modo de preenchimento como FillMode.Alternate.

private:
   void DrawClosedCurvePointTension( PaintEventArgs^ e )
   {
      // Create pens.
      Pen^ redPen = gcnew Pen( Color::Red,3.0f );
      Pen^ greenPen = gcnew Pen( Color::Green,3.0f );

      // Create points that define curve.
      Point point1 = Point(50,50);
      Point point2 = Point(100,25);
      Point point3 = Point(200,5);
      Point point4 = Point(250,50);
      Point point5 = Point(300,100);
      Point point6 = Point(350,200);
      Point point7 = Point(250,250);
      array<Point>^ curvePoints = {point1,point2,point3,point4,point5,point6,point7};

      // Draw lines between original points to screen.
      e->Graphics->DrawLines( redPen, curvePoints );

      // Create tension and fill mode.
      float tension = 1.0F;
      FillMode aFillMode = FillMode::Alternate;

      // Draw closed curve to screen.
      e->Graphics->DrawClosedCurve( greenPen, curvePoints, tension, aFillMode );
   }

private void DrawClosedCurvePointTension(PaintEventArgs e)
{

    // Create pens.
    Pen redPen = new Pen(Color.Red, 3);
    Pen greenPen = new Pen(Color.Green, 3);

    // Create points that define curve.
    Point point1 = new Point(50, 50);
    Point point2 = new Point(100, 25);
    Point point3 = new Point(200, 5);
    Point point4 = new Point(250, 50);
    Point point5 = new Point(300, 100);
    Point point6 = new Point(350, 200);
    Point point7 = new Point(250, 250);
    Point[] curvePoints = {point1, point2, point3, point4, point5, point6, point7};

    // Draw lines between original points to screen.
    e.Graphics.DrawLines(redPen, curvePoints);

    // Create tension and fill mode.
    float tension = 1.0F;
    FillMode aFillMode = FillMode.Alternate;

    // Draw closed curve to screen.
    e.Graphics.DrawClosedCurve(greenPen, curvePoints, tension, aFillMode);
}

Private Sub DrawClosedCurvePointTension(ByVal e As PaintEventArgs)

    ' Create pens.
    Dim redPen As New Pen(Color.Red, 3)
    Dim greenPen As New Pen(Color.Green, 3)

    ' Create points that define curve.
    Dim point1 As New Point(50, 50)
    Dim point2 As New Point(100, 25)
    Dim point3 As New Point(200, 5)
    Dim point4 As New Point(250, 50)
    Dim point5 As New Point(300, 100)
    Dim point6 As New Point(350, 200)
    Dim point7 As New Point(250, 250)
    Dim curvePoints As Point() = {point1, point2, point3, point4, _
    point5, point6, point7}

    ' Draw lines between original points to screen.
    e.Graphics.DrawLines(redPen, curvePoints)

    ' Create tension and fill mode.
    Dim tension As Single = 1.0F
    Dim aFillMode As FillMode = FillMode.Alternate

    ' Draw closed curve to screen.
    e.Graphics.DrawClosedCurve(greenPen, curvePoints, tension, _
    aFillMode)
End Sub

Comentários

Esse método desenha um spline cardinal fechado que passa por cada ponto na matriz. Se o último ponto não corresponder ao primeiro ponto, um segmento de curva adicional será adicionado do último ponto ao primeiro ponto para fechá-lo.

A matriz de pontos deve conter pelo menos quatro estruturas Point.

O parâmetro tension determina a forma do spline. Se o valor do parâmetro tension for 0,0F, esse método desenhará segmentos de linha reta para conectar os pontos. Normalmente, o parâmetro tension é menor ou igual a 1,0F. Valores acima de 1,0F produzem resultados incomuns.

DrawClosedCurve(Pen, Point[])

Origem:

Graphics.cs

Desenha um spline cardinal fechado definido por uma matriz de estruturas de Point.

public:
 void DrawClosedCurve(System::Drawing::Pen ^ pen, ... cli::array <System::Drawing::Point> ^ points);

public void DrawClosedCurve (System.Drawing.Pen pen, params System.Drawing.Point[] points);

member this.DrawClosedCurve : System.Drawing.Pen * System.Drawing.Point[] -> unit

Public Sub DrawClosedCurve (pen As Pen, ParamArray points As Point())

Parâmetros

pen

Pen

Pen que determina a cor, a largura e a altura da curva.

points

Point[]

Matriz de estruturas Point que definem o spline.

Exceções

ArgumentNullException

pen é null.

-ou-

points é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria canetas vermelhas e verdes.

• Cria sete pontos para definir uma curva.

• Desenha sete linhas retas vermelhas entre os sete pontos para formar um polígono fechado.

• Desenha uma curva fechada verde através dos sete pontos.

O método usa uma tensão padrão de 0,5.

private:
   void DrawClosedCurvePoint( PaintEventArgs^ e )
   {

      // Create pens.
      Pen^ redPen = gcnew Pen( Color::Red,3.0f );
      Pen^ greenPen = gcnew Pen( Color::Green,3.0f );

      // Create points that define curve.
      Point point1 = Point(50,50);
      Point point2 = Point(100,25);
      Point point3 = Point(200,5);
      Point point4 = Point(250,50);
      Point point5 = Point(300,100);
      Point point6 = Point(350,200);
      Point point7 = Point(250,250);
      array<Point>^ curvePoints = {point1,point2,point3,point4,point5,point6,point7};

      // Draw lines between original points to screen.
      e->Graphics->DrawLines( redPen, curvePoints );

      // Draw closed curve to screen.
      e->Graphics->DrawClosedCurve( greenPen, curvePoints );
   }

private void DrawClosedCurvePoint(PaintEventArgs e)
{
    // Create pens.
    Pen redPen   = new Pen(Color.Red, 3);
    Pen greenPen = new Pen(Color.Green, 3);
             
    // Create points that define curve.
    Point point1 = new Point(50,  50);
    Point point2 = new Point(100,  25);
    Point point3 = new Point(200,   5);
    Point point4 = new Point(250,  50);
    Point point5 = new Point(300, 100);
    Point point6 = new Point(350, 200);
    Point point7 = new Point(250, 250);
    Point[] curvePoints =
             {
                 point1,
                 point2,
                 point3,
                 point4,
                 point5,
                 point6,
                 point7
             };
             
    // Draw lines between original points to screen.
    e.Graphics.DrawLines(redPen, curvePoints);
             
    // Draw closed curve to screen.
    e.Graphics.DrawClosedCurve(greenPen, curvePoints);
}

Private Sub DrawClosedCurvePoint(ByVal e As PaintEventArgs)

    ' Create pens.
    Dim redPen As New Pen(Color.Red, 3)
    Dim greenPen As New Pen(Color.Green, 3)

    ' Create points that define curve.
    Dim point1 As New Point(50, 50)
    Dim point2 As New Point(100, 25)
    Dim point3 As New Point(200, 5)
    Dim point4 As New Point(250, 50)
    Dim point5 As New Point(300, 100)
    Dim point6 As New Point(350, 200)
    Dim point7 As New Point(250, 250)
    Dim curvePoints As Point() = {point1, point2, point3, point4, _
    point5, point6, point7}

    ' Draw lines between original points to screen.
    e.Graphics.DrawLines(redPen, curvePoints)

    ' Draw closed curve to screen.
    e.Graphics.DrawClosedCurve(greenPen, curvePoints)
End Sub

Comentários

Esse método desenha um spline cardinal fechado que passa por cada ponto na matriz. Se o último ponto não corresponder ao primeiro ponto, um segmento de curva adicional será adicionado do último ponto ao primeiro ponto para fechar a figura.

A matriz de pontos deve conter pelo menos quatro estruturas Point.

Esse método usa uma tensão padrão de 0,5.

DrawClosedCurve(Pen, PointF[])

Origem:

Graphics.cs

Desenha um spline cardinal fechado definido por uma matriz de estruturas de PointF.

public:
 void DrawClosedCurve(System::Drawing::Pen ^ pen, ... cli::array <System::Drawing::PointF> ^ points);

public void DrawClosedCurve (System.Drawing.Pen pen, params System.Drawing.PointF[] points);

member this.DrawClosedCurve : System.Drawing.Pen * System.Drawing.PointF[] -> unit

Public Sub DrawClosedCurve (pen As Pen, ParamArray points As PointF())

Parâmetros

pen

Pen

Pen que determina a cor, a largura e a altura da curva.

points

PointF[]

Matriz de estruturas PointF que definem o spline.

Exceções

ArgumentNullException

pen é null.

-ou-

points é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria canetas vermelhas e verdes.

• Cria sete pontos para definir uma curva.

• Desenha sete linhas retas vermelhas entre os sete pontos para formar um polígono fechado.

• Desenha uma curva fechada verde através dos sete pontos.

O método usa uma tensão padrão de 0,5.

private:
   void DrawClosedCurvePointF( PaintEventArgs^ e )
   {
      // Create pens.
      Pen^ redPen = gcnew Pen( Color::Red,3.0f );
      Pen^ greenPen = gcnew Pen( Color::Green,3.0f );

      // Create points that define curve.
      PointF point1 = PointF(50.0F,50.0F);
      PointF point2 = PointF(100.0F,25.0F);
      PointF point3 = PointF(200.0F,5.0F);
      PointF point4 = PointF(250.0F,50.0F);
      PointF point5 = PointF(300.0F,100.0F);
      PointF point6 = PointF(350.0F,200.0F);
      PointF point7 = PointF(250.0F,250.0F);
      array<PointF>^ curvePoints = {point1,point2,point3,point4,point5,point6,point7};

      // Draw lines between original points to screen.
      e->Graphics->DrawLines( redPen, curvePoints );

      // Draw closed curve to screen.
      e->Graphics->DrawClosedCurve( greenPen, curvePoints );
   }

private void DrawClosedCurvePointF(PaintEventArgs e)
{

    // Create pens.
    Pen redPen = new Pen(Color.Red, 3);
    Pen greenPen = new Pen(Color.Green, 3);

    // Create points that define curve.
    PointF point1 = new PointF(50.0F, 50.0F);
    PointF point2 = new PointF(100.0F, 25.0F);
    PointF point3 = new PointF(200.0F, 5.0F);
    PointF point4 = new PointF(250.0F, 50.0F);
    PointF point5 = new PointF(300.0F, 100.0F);
    PointF point6 = new PointF(350.0F, 200.0F);
    PointF point7 = new PointF(250.0F, 250.0F);
    PointF[] curvePoints = {point1, point2, point3, point4, point5, point6, point7};

    // Draw lines between original points to screen.
    e.Graphics.DrawLines(redPen, curvePoints);

    // Draw closed curve to screen.
    e.Graphics.DrawClosedCurve(greenPen, curvePoints);
}

Private Sub DrawClosedCurvePointF(ByVal e As PaintEventArgs)

    ' Create pens.
    Dim redPen As New Pen(Color.Red, 3)
    Dim greenPen As New Pen(Color.Green, 3)

    ' Create points that define curve.
    Dim point1 As New PointF(50.0F, 50.0F)
    Dim point2 As New PointF(100.0F, 25.0F)
    Dim point3 As New PointF(200.0F, 5.0F)
    Dim point4 As New PointF(250.0F, 50.0F)
    Dim point5 As New PointF(300.0F, 100.0F)
    Dim point6 As New PointF(350.0F, 200.0F)
    Dim point7 As New PointF(250.0F, 250.0F)
    Dim curvePoints As PointF() = {point1, point2, point3, point4, _
    point5, point6, point7}

    ' Draw lines between original points to screen.
    e.Graphics.DrawLines(redPen, curvePoints)

    ' Draw closed curve to screen.
    e.Graphics.DrawClosedCurve(greenPen, curvePoints)
End Sub

Comentários

Esse método desenha um spline cardinal fechado que passa por cada ponto na matriz. Se o último ponto não corresponder ao primeiro ponto, um segmento de curva adicional será adicionado do último ponto ao primeiro ponto para fechá-lo.

A matriz de pontos deve conter pelo menos quatro estruturas PointF.

Esse método usa uma tensão padrão de 0,5.