Graphics.DrawPolygon Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Zeichnet ein Vieleck, das durch ein Array von Point-Strukturen definiert ist.

Überlädt

DrawPolygon(Pen, Point[])	Zeichnet ein Vieleck, das durch ein Array von Point-Strukturen definiert ist.
DrawPolygon(Pen, PointF[])	Zeichnet ein Vieleck, das durch ein Array von PointF-Strukturen definiert ist.

DrawPolygon(Pen, Point[])

Quelle:

Graphics.cs

Zeichnet ein Vieleck, das durch ein Array von Point-Strukturen definiert ist.

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

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

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

Public Sub DrawPolygon (pen As Pen, points As Point())

Parameter

pen

Pen

Pen, der die Farbe, Breite und den Stil des Vielecks bestimmt.

points

Point[]

Array von Point-Strukturen, die die Eckpunkte des Vielecks darstellen.

Ausnahmen

ArgumentNullException

pen ist null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

• Erstellt einen schwarzen Stift.

• Erstellt ein Array von sieben Punkten für die Scheitelpunkte des Polygons.

• Zeichnet das Polygon auf den Bildschirm.

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

Hinweise

Jedes Paar von zwei aufeinanderfolgenden Punkten im Array gibt eine Seite des Polygons an. Wenn der letzte Punkt und der erste Punkt des Arrays nicht übereinstimmen, geben sie außerdem die letzte Seite des Polygons an.

DrawPolygon(Pen, PointF[])

Quelle:

Graphics.cs

Zeichnet ein Vieleck, das durch ein Array von PointF-Strukturen definiert ist.

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

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

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

Public Sub DrawPolygon (pen As Pen, points As PointF())

Parameter

pen

Pen

Pen, der die Farbe, Breite und den Stil des Vielecks bestimmt.

points

PointF[]

Array von PointF-Strukturen, die die Eckpunkte des Vielecks darstellen.

Ausnahmen

ArgumentNullException

pen ist null.

- oder -

points ist null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

• Erstellt einen schwarzen Stift.

• Erstellt ein Array von sieben Punkten für die Scheitelpunkte des Polygons.

• Zeichnet das Polygon auf den Bildschirm.

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

Hinweise

Jedes Paar von zwei aufeinanderfolgenden Punkten im Array gibt eine Seite des Polygons an. Wenn der letzte Punkt und der erste des Arraypunkts nicht übereinstimmen, geben sie außerdem die letzte Seite des Polygons an.