Graphics.DrawPolygon Método

Definição

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

Sobrecargas

DrawPolygon(Pen, Point[])

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

DrawPolygon(Pen, PointF[])

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

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

DrawPolygon(Pen, Point[])

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

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

Parâmetros

pen
Pen

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

points
Point[]

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

Exceções

pen é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. 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.

public:
   void DrawPolygonPoint( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create points that define polygon.
      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 polygon to screen.
      e->Graphics->DrawPolygon( blackPen, curvePoints );
   }
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);
}
Public Sub DrawPolygonPoint(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create points that define polygon.
    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 polygon to screen.
    e.Graphics.DrawPolygon(blackPen, curvePoints)
End Sub

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

DrawPolygon(Pen, PointF[])

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

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

Parâmetros

pen
Pen

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

points
PointF[]

Matriz de estruturas PointF que representa 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 Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. 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.

public:
   void DrawPolygonPointF( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create points that define polygon.
      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 polygon curve to screen.
      e->Graphics->DrawPolygon( blackPen, curvePoints );
   }
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);
}
Public Sub DrawPolygonPointF(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create points that define polygon.
    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 polygon curve to screen.
    e.Graphics.DrawPolygon(blackPen, curvePoints)
End Sub

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

DrawPolygon(Pen, ReadOnlySpan<Point>)

public:
 void DrawPolygon(System::Drawing::Pen ^ pen, ReadOnlySpan<System::Drawing::Point> points);
public void DrawPolygon (System.Drawing.Pen pen, ReadOnlySpan<System.Drawing.Point> points);
member this.DrawPolygon : System.Drawing.Pen * ReadOnlySpan<System.Drawing.Point> -> unit
Public Sub DrawPolygon (pen As Pen, points As ReadOnlySpan(Of Point))

Parâmetros

pen
Pen

Aplica-se a

DrawPolygon(Pen, ReadOnlySpan<PointF>)

public:
 void DrawPolygon(System::Drawing::Pen ^ pen, ReadOnlySpan<System::Drawing::PointF> points);
public void DrawPolygon (System.Drawing.Pen pen, ReadOnlySpan<System.Drawing.PointF> points);
member this.DrawPolygon : System.Drawing.Pen * ReadOnlySpan<System.Drawing.PointF> -> unit
Public Sub DrawPolygon (pen As Pen, points As ReadOnlySpan(Of PointF))

Parâmetros

pen
Pen

Aplica-se a