VintaSoft Imaging .NET SDK 14.0: 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
    )
    public: virtual void DrawString(
    System.String text,
    IDrawingFont* font,
    IDrawingBrush* brush,
    System.Drawing.PointF point
    )
    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: .NET9; .NET 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

    See Also