Graphics.DrawPolygon Metoda

Definicja

Rysuje wielokąt zdefiniowany przez tablicę struktur Point.

Przeciążenia

DrawPolygon(Pen, Point[])

Rysuje wielokąt zdefiniowany przez tablicę struktur Point.

DrawPolygon(Pen, PointF[])

Rysuje wielokąt zdefiniowany przez tablicę struktur PointF.

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

DrawPolygon(Pen, Point[])

Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs

Rysuje wielokąt zdefiniowany przez tablicę struktur 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);

Parametry

pen
Pen

Pen, który określa kolor, szerokość i styl wielokąta.

points
Point[]

Tablica struktur Point reprezentujących wierzchołki wielokąta.

Wyjątki

pen jest null.

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z formularzami Systemu Windows i wymaga PaintEventArgse, który jest parametrem programu obsługi zdarzeń Paint. Kod wykonuje następujące akcje:

  • Tworzy długopis.

  • Tworzy tablicę siedmiu punktów dla wierzchołków wielokąta.

  • Rysuje wielokąt do ekranu.

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

Uwagi

Każda para dwóch kolejnych punktów w tablicy określa stronę wielokąta. Ponadto, jeśli ostatni punkt i pierwszy punkt tablicy nie zbiegają się, określają ostatnią stronę wielokąta.

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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[])

Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs

Rysuje wielokąt zdefiniowany przez tablicę struktur 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);

Parametry

pen
Pen

Pen, który określa kolor, szerokość i styl wielokąta.

points
PointF[]

Tablica struktur PointF reprezentujących wierzchołki wielokąta.

Wyjątki

pen jest null.

-lub-

points jest null.

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z formularzami Systemu Windows i wymaga PaintEventArgse, który jest parametrem programu obsługi zdarzeń Paint. Kod wykonuje następujące akcje:

  • Tworzy długopis.

  • Tworzy tablicę siedmiu punktów dla wierzchołków wielokąta.

  • Rysuje wielokąt do ekranu.

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

Uwagi

Każda para dwóch kolejnych punktów w tablicy określa stronę wielokąta. Ponadto, jeśli ostatni punkt i pierwszy punktu tablicy nie zbiegają się, określają ostatnią stronę wielokąta.

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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>)

Źródło:
Graphics.cs
Źródło:
Graphics.cs
C#
public void DrawPolygon (System.Drawing.Pen pen, scoped ReadOnlySpan<System.Drawing.Point> points);

Parametry

pen
Pen

Dotyczy

.NET 9 i Windows Desktop 9
Produkt Wersje
.NET 9
Windows Desktop 9

DrawPolygon(Pen, ReadOnlySpan<PointF>)

Źródło:
Graphics.cs
Źródło:
Graphics.cs
C#
public void DrawPolygon (System.Drawing.Pen pen, scoped ReadOnlySpan<System.Drawing.PointF> points);

Parametry

pen
Pen

Dotyczy

.NET 9 i Windows Desktop 9
Produkt Wersje
.NET 9
Windows Desktop 9