Graphics::DrawString Method (String^, Font^, Brush^, Single, Single)
Draws the specified text string at the specified location with the specified Brush and Font objects.
Assembly: System.Drawing (in System.Drawing.dll)
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.
| Exception | Condition |
|---|---|
| ArgumentNullException | brush is null. -or- s is null. |
The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, 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. System::Drawing::Font^ drawFont = gcnew System::Drawing::Font( "Arial",16 ); SolidBrush^ drawBrush = gcnew 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 ); }
Available since 1.1