BrickGraphics.DrawString(String, RectangleF) Method

Adds a specific TextBrick to a report.

Namespace: DevExpress.XtraPrinting

Assembly: DevExpress.Printing.v24.1.Core.dll

NuGet Package: DevExpress.Printing.Core

Declaration

C#

public TextBrick DrawString(
    string text,
    RectangleF rect
)

VB.NET

Public Function DrawString(
    text As String,
    rect As RectangleF
) As TextBrick

Parameters

Name	Type	Description
text	String	The text displayed in a specific TextBrick.
rect	RectangleF	The RectangleF structure that specifies the location and size of the current brick in measurement units, specified via the BrickGraphics.PageUnit property value.

Returns

Type	Description
TextBrick	The TextBrick added to a report.

Remarks

This method adds a specific TextBrick to a report. TextBrick position and size are specified via the rect parameter. Graphical settings which are not defined via this method are obtained from the corresponding BrickGraphics properties.

Example

This example demonstrates how to create a TextBrick using the BrickGraphics.DrawString method.

C#

using DevExpress.XtraPrinting;
// ...

    VisualBrick visBrick;
    BrickGraphics brickGraph = printingSystem1.Graph;
    string s = "Developer Express Inc.";

    // Measure the string.
    SizeF sz = brickGraph.MeasureString(s);

    // Start the report generation.
    printingSystem1.Begin();

    // Create a rectangle of the calculated size.
    RectangleF rect = new RectangleF(new PointF(0, 0), sz);
    // Specify a page area.
    brickGraph.Modifier = BrickModifier.Detail;
    // Create a text brick.
    visBrick = brickGraph.DrawString(s, Color.Black, rect, BorderSide.All);

    // Finish the report generation.
    printingSystem1.End();

    // Preview the report.
    printingSystem1.PreviewFormEx.Show();

VB.NET

Imports DevExpress.XtraPrinting
' ...

    Dim visBrick As VisualBrick
    Dim brickGraph As BrickGraphics = printingSystem1.Graph
    Dim s As String = "Developer Express Inc."

    ' Measure the string.
    Dim sz As SizeF = brickGraph.MeasureString(s)

    ' Start the report generation.
    printingSystem1.Begin()

    ' Create a rectangle of the calculated size.
    Dim rect As RectangleF = New RectangleF(New PointF(0, 0), sz)
    ' Specify a page area.
    brickGraph.Modifier = BrickModifier.Detail
    ' Create a text brick.
    visBrick = brickGraph.DrawString(s, Color.Black, rect, BorderSide.All)

    ' Finish the report generation.
    printingSystem1.End()

    ' Preview the report.
    printingSystem1.PreviewFormEx.Show()

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the DrawString(String, RectangleF) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

reporting-winforms-handle-link-events/CS/UseLinkEvents/Form1.cs#L59

// Draw 3 bricks containing "I love you".
e.Graph.DrawString("I", new Rectangle(0, 0, 150, 25));
e.Graph.DrawString("love", new Rectangle(150, 0, 50, 25));

VB.NET

reporting-winforms-handle-link-events/VB/UseLinkEvents/Form1.vb#L62

' Draw 3 bricks containing "I love you".
e.Graph.DrawString("I", New Rectangle(0, 0, 150, 25))
e.Graph.DrawString("love", New Rectangle(150, 0, 50, 25))