Export (0) Print
Expand All

Graphics.DrawString Method (String, Font, Brush, Single, Single)

Draws the specified text string at the specified location with the specified Brush and Font objects.

Namespace:  System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public void DrawString(
	string s,
	Font font,
	Brush brush,
	float x,
	float y
)

Parameters

s
Type: System.String

String to draw.

font
Type: System.Drawing.Font

Font that defines the text format of the string.

brush
Type: System.Drawing.Brush

Brush that determines the color and texture of the drawn text.

x
Type: System.Single

The x-coordinate of the upper-left corner of the drawn text.

y
Type: System.Single

The y-coordinate of the upper-left corner of the drawn text.

ExceptionCondition
ArgumentNullException

brush is null.

-or-

s is null.

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

  • Creates a text string to draw.

  • Defines the font as Arial (16pt).

  • Creates a solid black brush to draw with.

  • Creates a point for the upper-left corner at which to draw the text.

  • Draws the string to the screen using the font, brush, and destination point.

public void DrawStringFloat(PaintEventArgs e)
{

    // Create string to draw.
    String drawString = "Sample Text";

    // Create font and brush.
    Font drawFont = new Font("Arial", 16);
    SolidBrush drawBrush = new SolidBrush(Color.Black);

    // Create point for upper-left corner of drawing. 
    float x = 150.0F;
    float y = 150.0F;

    // Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, x, y);
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft