PdfGraphics.TextOrigin Property

Specifies how to interpret a point passed to the PdfGraphics.DrawString method as a parameter.

Namespace: DevExpress.Pdf

Assembly: DevExpress.Pdf.v23.2.Drawing.dll

NuGet Package: DevExpress.Pdf.Drawing

Declaration

C#

public PdfGraphicsTextOrigin TextOrigin { get; set; }

VB.NET

Public Property TextOrigin As PdfGraphicsTextOrigin

Property Value

Type	Description
PdfGraphicsTextOrigin	Indicates the point location relative to the drawn text.

Available values:

Name	Description
TopLeftCorner	The point is the top left corner of the text rectangle.
Baseline	The point is on the text baseline.

Remarks

Use the TextOrigin property to change the location of a point passed to one of the following DrawString overloads as a parameter:

• PdfGraphics.DrawString(String, Font, SolidBrush, PointF)
• PdfGraphics.DrawString(String, Font, SolidBrush, PointF, PdfStringFormat)
• PdfGraphics.DrawString(String, Font, SolidBrush, Single, Single)
• PdfGraphics.DrawString(String, Font, SolidBrush, Single, Single, PdfStringFormat)

The image below shows the difference between PdfGraphicsTextOrigin.TopLeftCorner and PdfGraphicsTextOrigin.Baseline values.

The text point is calculated as follows:

C#

using DevExpress.Pdf;
using System.Drawing;
//...
using (var processor = new PdfDocumentProcessor())
{
    processor.CreateEmptyDocument();

    using (PdfGraphics graphics = processor.CreateGraphics())
    {
        PdfPage page = processor.AddNewPage(PdfPaperSize.A4);
        PdfRectangle pageSize = page.CropBox;

        string text = "DevExpress";
        using (SolidBrush textBrush = new SolidBrush(Color.FromArgb(255, Color.DarkOrange)))
        {
            using (Font font = new Font("Segoe UI", 20, FontStyle.Regular))
            {
                SizeF textSize = graphics.MeasureString(text, font);
                PointF textPoint =
                   new PointF((float)((pageSize.Width - textSize.Width) / 2), (float)((pageSize.Height - textSize.Height) / 2));
                graphics.TextOrigin = PdfGraphicsTextOrigin.Baseline;

                graphics.DrawString(text, font, textBrush, textPoint);
                graphics.AddToPageForeground(page, 72, 72);
            }
        }
    }
    processor.SaveDocument("result.pdf");
}

VB.NET

Imports DevExpress.Pdf
Imports System.Drawing
'...
Using processor = New PdfDocumentProcessor()
  processor.CreateEmptyDocument()

  Using graphics As PdfGraphics = processor.CreateGraphics()
    Dim page As PdfPage = processor.AddNewPage(PdfPaperSize.A4)
    Dim pageSize As PdfRectangle = page.CropBox

    Dim text As String = "DevExpress"
    Using textBrush As New SolidBrush(Color.FromArgb(255, Color.DarkOrange))
      Using font As New Font("Segoe UI", 20, FontStyle.Regular)
        Dim textSize As SizeF = graphics.MeasureString(text, font)
        Dim textPoint As
           New PointF(CSng((pageSize.Width - textSize.Width) \ 2), CSng((pageSize.Height - textSize.Height) \ 2))
        graphics.TextOrigin = PdfGraphicsTextOrigin.Baseline

        graphics.DrawString(text, font, textBrush, textPoint)
        ' Add graphics content to the page foreground
        graphics.AddToPageForeground(page, 72, 72)
      End Using
    End Using
  End Using
  processor.SaveDocument("result.pdf")
End Using