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.

C#

public void DrawClosedCurve (System.Drawing.Pen pen, System.Drawing.PointF[] points, float tension, System.Drawing.Drawing2D.FillMode 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.

C#

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);
}

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.

C#

public void DrawClosedCurve (System.Drawing.Pen pen, System.Drawing.Point[] points, float tension, System.Drawing.Drawing2D.FillMode 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.

C#

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);
}

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.

C#

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

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.

C#

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);
}

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.

C#

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

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.

C#

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);
}

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.