Ler em inglês

Partilhar via


Graphics.DrawPolygon Método

Definição

Desenha um polígono definido por uma matriz de estruturas de Point.

Sobrecargas

DrawPolygon(Pen, Point[])

Desenha um polígono definido por uma matriz de estruturas de Point.

DrawPolygon(Pen, PointF[])

Desenha um polígono definido por uma matriz de estruturas de PointF.

DrawPolygon(Pen, ReadOnlySpan<Point>)
DrawPolygon(Pen, ReadOnlySpan<PointF>)

DrawPolygon(Pen, Point[])

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha um polígono definido por uma matriz de estruturas de Point.

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

Parâmetros

pen
Pen

Pen que determina a cor, a largura e o estilo do polígono.

points
Point[]

Matriz de estruturas Point que representam os vértices do polígono.

Exceções

pen é 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 uma caneta preta.

  • Cria uma matriz de sete pontos para os vértices do polígono.

  • Desenha o polígono para a tela.

C#
public void DrawPolygonPoint(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create points that define polygon.
    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 polygon to screen.
    e.Graphics.DrawPolygon(blackPen, curvePoints);
}

Comentários

Cada par de dois pontos consecutivos na matriz especifica um lado do polígono. Além disso, se o último ponto e o primeiro ponto da matriz não coincidirem, eles especificarão o último lado do polígono.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

DrawPolygon(Pen, PointF[])

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha um polígono definido por uma matriz de estruturas de PointF.

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

Parâmetros

pen
Pen

Pen que determina a cor, a largura e o estilo do polígono.

points
PointF[]

Matriz de estruturas PointF que representam os vértices do polígono.

Exceções

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 uma caneta preta.

  • Cria uma matriz de sete pontos para os vértices do polígono.

  • Desenha o polígono para a tela.

C#
public void DrawPolygonPointF(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create points that define polygon.
    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 polygon curve to screen.
    e.Graphics.DrawPolygon(blackPen, curvePoints);
}

Comentários

Cada par de dois pontos consecutivos na matriz especifica um lado do polígono. Além disso, se o último ponto e o primeiro do ponto de matriz não coincidirem, eles especificarão o último lado do polígono.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

DrawPolygon(Pen, ReadOnlySpan<Point>)

Origem:
Graphics.cs
Origem:
Graphics.cs
C#
public void DrawPolygon (System.Drawing.Pen pen, scoped ReadOnlySpan<System.Drawing.Point> points);

Parâmetros

pen
Pen

Aplica-se a

.NET 9 e Windows Desktop 9
Produto Versões
.NET 9
Windows Desktop 9

DrawPolygon(Pen, ReadOnlySpan<PointF>)

Origem:
Graphics.cs
Origem:
Graphics.cs
C#
public void DrawPolygon (System.Drawing.Pen pen, scoped ReadOnlySpan<System.Drawing.PointF> points);

Parâmetros

pen
Pen

Aplica-se a

.NET 9 e Windows Desktop 9
Produto Versões
.NET 9
Windows Desktop 9