VintaSoft Imaging .NET SDK 15.1: Documentation for .NET developer
Vintasoft.Imaging.Drawing Namespace / DrawingEngine Class / DrawString Methods / DrawString(String,IDrawingFont,IDrawingBrush,PointF) Method
Syntax Example Requirements SeeAlso
In This Topic
DrawString(String,IDrawingFont,IDrawingBrush,PointF) Method (DrawingEngine)
In This Topic
Draws the specified Unicode string at the specified location using the specified IDrawingBrush and IDrawingFont objects.
Syntax
'Declaration

Public Overloads Overridable Sub DrawString( _
ByVal text
A string in Unicode encoding to draw.
As System.String, _
ByVal font
The font, which should be used for drawing text.
As IDrawingFont, _
ByVal brush
The brush, which should be used for drawing text.
As IDrawingBrush, _
ByVal point
The upper-left corner of the drawn text.
As System.Drawing.PointF _
)
public virtual void DrawString(
System.String text,
IDrawingFont font,
IDrawingBrush brush,
System.Drawing.PointF point
)

Parameters

text
A string in Unicode encoding to draw.
font
The font, which should be used for drawing text.
brush
The brush, which should be used for drawing text.
point
The upper-left corner of the drawn text.
Example

Here is an example that shows how to draw string using drawing engine.


''' <summary>
''' Draws strings on specified drawing engine.
''' </summary>
''' <param name="drawingEngine">Drawing engine.</param>
''' <param name="area">Area to draw objects in.</param>
Public Shared Sub DrawStringExample(drawingEngine As DrawingEngine, area As RectangleF)
    ' set font size
    Dim fontSize As Single = (area.Width + area.Height) * 0.06F

    ' create font and brush to draw string
    Using font As IDrawingFont = drawingEngine.DrawingFactory.CreateFont("Arial", fontSize, False, True)
        Using brush As IDrawingSolidBrush = drawingEngine.DrawingFactory.CreateSolidBrush(Color.Blue)
            ' draw string
            drawingEngine.DrawString("Arial italic string example!", font, brush, New PointF(area.X, area.Y))
        End Using
    End Using

    ' create font and brush to draw string
    Using font As IDrawingFont = drawingEngine.DrawingFactory.CreateFont("Calibri", fontSize, True, False)
        Using brush As IDrawingSolidBrush = drawingEngine.DrawingFactory.CreateSolidBrush(Color.Purple)
            ' draw string
            drawingEngine.DrawString("Calibri bold string example!", font, brush, New PointF(area.X, area.Y + area.Height * 0.5F))
        End Using
    End Using
End Sub


/// <summary>
/// Draws strings on specified drawing engine.
/// </summary>
/// <param name="drawingEngine">Drawing engine.</param>
/// <param name="area">Area to draw objects in.</param>
public static void DrawStringExample(DrawingEngine drawingEngine, RectangleF area)
{
    // set font size
    float fontSize = (area.Width + area.Height) * 0.06f;

    // create font and brush to draw string
    using (IDrawingFont font = drawingEngine.DrawingFactory.CreateFont("Arial", fontSize, false, true))
    using (IDrawingSolidBrush brush = drawingEngine.DrawingFactory.CreateSolidBrush(Color.Blue))
    {
        // draw string
        drawingEngine.DrawString("Arial italic string example!", font, brush, new PointF(area.X, area.Y));
    }

    // create font and brush to draw string
    using (IDrawingFont font = drawingEngine.DrawingFactory.CreateFont("Calibri", fontSize, true, false))
    using (IDrawingSolidBrush brush = drawingEngine.DrawingFactory.CreateSolidBrush(Color.Purple))
    {
        // draw string
        drawingEngine.DrawString("Calibri bold string example!", font, brush, new PointF(area.X, area.Y + area.Height * 0.5f));
    }
}

Requirements

Target Platforms: .NET 10; .NET 9; .NET 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

See Also