PdfGraphics.DrawPolygon(DXPen, PointF[]) Method

Draws a polygon by points from the specified array.

Namespace: DevExpress.Pdf

Assembly: DevExpress.Pdf.v25.1.Drawing.dll

NuGet Package: DevExpress.Pdf.Drawing

Declaration

C#

public void DrawPolygon(
    DXPen pen,
    PointF[] points
)

VB.NET

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

Parameters

Name	Type	Description
pen	DXPen	A DXPen object that specifies the color, width, and style of the polygon.
points	PointF[]	An array of PointF structures that specify the polygon vertices (in world coordinate system).

Remarks

The first two points of the points array specify the first polygon side. Each next side connects the previous side’s end point and the next array point. If the first and last array points are different, they specify the last polygon side. Pass the points and pen parameters to the DrawPolygon method to draw a polygon.

To draw a shape on the PDF page, use one of the following methods:

PdfGraphics.AddToPageForeground, PdfGraphics.AddToPageBackground

These methods allow you to draw content on an existing page.

PdfDocumentProcessor.RenderNewPage

Draws content on a new page.

The code sample below draws a polygon by seven points.

C#

using DevExpress.Pdf;
using System.Drawing;
using DevExpress.Drawing;
//...

using (PdfDocumentProcessor processor = new PdfDocumentProcessor())
{
    processor.CreateEmptyDocument();
    PdfPage page = processor.AddNewPage(PdfPaperSize.A4);
        using (PdfGraphics graphics = processor.CreateGraphics())
        {
            // Create a point array.
            PointF[] points = new PointF[] 
            { 
                new PointF(50, 50), 
                new PointF(200, 10), 
                new PointF(450, 150), 
                new PointF(500, 200), 
                new PointF(520, 350), 
                new PointF(570, 650), 
                new PointF(500, 700) 
            };

            // Draw a polygon.
            using (var pen = new DXPen(Color.Red, 5))
                graphics.DrawPolygon(pen, points);

            // Add graphics content to the document page.
            graphics.AddToPageForeground(page, 72, 72);
        }
    processor.SaveDocument("out2.pdf");
}
Process.Start("out.pdf");

VB.NET

Imports DevExpress.Pdf
Imports System.Drawing
Imports DevExpress.Drawing
'...

Using processor As New PdfDocumentProcessor()
    processor.CreateEmptyDocument()
    Dim page As PdfPage = processor.AddNewPage(PdfPaperSize.A4)
        Using graphics As PdfGraphics = processor.CreateGraphics()
            ' Create a point array.
            Dim points() As PointF = {
                New PointF(50, 50),
                New PointF(200, 10),
                New PointF(450, 150),
                New PointF(500, 200),
                New PointF(520, 350),
                New PointF(570, 650),
                New PointF(500, 700)
            }

            ' Draw a polygon.
            Using pen As New DXPen(Color.Red, 5)
                graphics.DrawPolygon(pen, points)
            End Using

            ' Add graphics content to the document page.
            graphics.AddToPageForeground(page, 72, 72)
        End Using
    processor.SaveDocument("out2.pdf")
End Using
Process.Start("out.pdf")