This documentation is for the old version. Go to the latest Graphics Mill docs

GdiGraphics.DrawString Method (String, Font, Pen, Brush, Int32, Int32)

Draws an outlined text at specified position.

Namespace: Aurigma.GraphicsMill.Drawing
Assembly: Aurigma.GraphicsMill (in Aurigma.GraphicsMill.dll)

Syntax

Visual Basic
Public Sub DrawString ( _
	s As String, _
	font As Font, _
	pen As Pen, _
	brush As Brush, _
	x As Integer, _
	y As Integer _
)
C#
public void DrawString(
	string s,
	Font font,
	Pen pen,
	Brush brush,
	int x,
	int y
)

Parameters

s

Type: System.String

String to draw.
font

Type: Aurigma.GraphicsMill.Drawing.Font

Font object specifying text rendering options.
pen

Type: Aurigma.GraphicsMill.Drawing.Pen

Pen object used to outline the text. If you need only fill the string, pass an empty pen here (you can get it with static method Empty of the Pen class).
brush

Type: Aurigma.GraphicsMill.Drawing.Brush

Brush object used to fill the text. If you need only outline the string, pass an empty brush here (you can get it with static method Empty of the Brush class).
x

Type: System.Int32

X-coordinate of the text output point. Actual position of the text relatively this point is defined with HorizontalAlignment and VerticalAlignment properties of the font argument.
y

Type: System.Int32

Y-coordinate of the text output point. Actual position of the text relatively this point is defined with HorizontalAlignment and VerticalAlignment properties of the font argument.

Remarks

All the coordinates are measured in units specified with Unit property.

Note

If you draw text on indexed bitmaps, antialiasing is disabled regardless to the Antialiased property value. Also, if the GdiGraphics was created on the base of the Bitmap which has Format8bppGrayScale pixel format, antialiasing will not be applied for text output. The reason of this issue is that GDI does not support grayscale bitmaps. That's why Graphics Mill for .NET represents this image as Format8bppIndexed bitmap with grayscale palette.

Examples

Visual Basic
Dim bitmap As New Aurigma.GraphicsMill.Bitmap(Aurigma.GraphicsMill.RgbColor.White, 320, 100, _
    Aurigma.GraphicsMill.PixelFormat.Format24bppRgb)

Dim graphics As Aurigma.GraphicsMill.Drawing.GdiGraphics = bitmap.GetGdiGraphics()

Dim font As New Aurigma.GraphicsMill.Drawing.Font("Arial", 50, False, False)

Dim brush As New Aurigma.GraphicsMill.Drawing.SolidBrush(Aurigma.GraphicsMill.RgbColor.Yellow)

Dim pen As New Aurigma.GraphicsMill.Drawing.Pen(Aurigma.GraphicsMill.RgbColor.Red, 1)

'Draw both filled and outlined text
graphics.DrawString("Sample text", font, pen, brush, 20, 20)
C#
Aurigma.GraphicsMill.Bitmap bitmap = new Aurigma.GraphicsMill.Bitmap(
    Aurigma.GraphicsMill.RgbColor.White, 320, 100, 
    Aurigma.GraphicsMill.PixelFormat.Format24bppRgb);

Aurigma.GraphicsMill.Drawing.GdiGraphics graphics = bitmap.GetGdiGraphics();

Aurigma.GraphicsMill.Drawing.Font font = new Aurigma.GraphicsMill.Drawing.Font(
    "Arial", 50, false, false);

Aurigma.GraphicsMill.Drawing.SolidBrush brush = new Aurigma.GraphicsMill.Drawing.SolidBrush( 
    Aurigma.GraphicsMill.RgbColor.Yellow);

Aurigma.GraphicsMill.Drawing.Pen pen  = new Aurigma.GraphicsMill.Drawing.Pen(
    Aurigma.GraphicsMill.RgbColor.Red, 1);

//Draw both filled and outlined text
graphics.DrawString("Sample text", font, pen, brush, 20, 20);

See Also

Reference