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

GdiGraphics.DrawText Method (String, Font, SolidBrush, Single, Single, Single, Single, Boolean, Int32)

Draws text in the specified rectangle taking into account its line breaks and justification.

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

Syntax

Visual Basic
Public Sub DrawText ( _
	s As String, _
	font As Font, _
	brush As SolidBrush, _
	x As Single, _
	y As Single, _
	width As Single, _
	height As Single, _
	clipping As Boolean, _
	tabSize As Integer _
)
C#
public void DrawText(
	string s,
	Font font,
	SolidBrush brush,
	float x,
	float y,
	float width,
	float height,
	bool clipping,
	int tabSize
)

Parameters

s

Type: System.String

Multiline text to draw.
font

Type: Aurigma.GraphicsMill.Drawing.Font

Font object specifying text rendering options.
brush

Type: Aurigma.GraphicsMill.Drawing.SolidBrush

SolidBrush object containing font color.
x

Type: System.Single

X-coordinate of the left top corner of the destination rectangle.
y

Type: System.Single

Y-coordinate of the left top corner of the destination rectangle.
width

Type: System.Single

Width of the destination rectangle.
height

Type: System.Single

Height of the destination rectangle.
clipping

Type: System.Boolean

Value specifying whether to clip the text when it does not fit the bounding rectangle. If this value is false all the lines of the text will be rendered regardless of the destination rectangle.
tabSize

Type: System.Int32

Value which specifies the number of whitespaces to replace one tabulation character in the text.

Remarks

All the coordinates are measured in units specified with Unit property. If the destination rectangle width is 0 the text will not be wrapped during the drawing. The extent of the text drawn by this method can be measured using the Font.MeasureText method.

The DrawText() method supports newline (\n in C# and vbNewLine in VB) and tabulation (\t in C# and vbTab in VB) characters. It makes the characters after the newline symbol be displayed in a new line and replaces the tabulation character with the specified number of whitespaces.

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.

See Also

Reference

Manual