Back to Devexpress

BrickGraphics.StringFormat Property

corelibraries-devexpress-dot-xtraprinting-dot-brickgraphics-b36c8d37.md

latest6.0 KB
Original Source

BrickGraphics.StringFormat Property

Gets or sets text layout information (such as alignment, orientation and tab stops) and display manipulations (such as ellipsis insertion and national digit substitution).

Namespace : DevExpress.XtraPrinting

Assembly : DevExpress.Printing.v25.2.Core.dll

NuGet Package : DevExpress.Printing.Core

Declaration

csharp
public BrickStringFormat StringFormat { get; set; }
vb
Public Property StringFormat As BrickStringFormat

Property Value

TypeDescription
BrickStringFormat

A BrickStringFormat object containing text information.

|

Example

The following code demonstrates use of the BrickStringFormat. It creates a new BrickStringFormat object, sets the text alignment to Center , and text direction to DirectionVertical.

csharp
using DevExpress.XtraPrinting;
// ...

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

    // Specify the string format.
    StringFormat sFormat = new StringFormat(StringFormatFlags.DirectionVertical);
    sFormat.Alignment = StringAlignment.Center;
    sFormat.LineAlignment = StringAlignment.Center;

    // Create the BrickStringFormat object.
    BrickStringFormat brickSFormat = new BrickStringFormat(sFormat);

    // Measure the string according to the specified format
    SizeF sz = brickGraph.MeasureString(s, 30, sFormat);

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

    // Set the brick string format
    brickGraph.StringFormat = brickSFormat;

    // Create a rectangle.
    RectangleF rect = new RectangleF(new PointF(0, 0), new SizeF(30, 150));
    // Specify a page area.
    brickGraph.Modifier = BrickModifier.Detail;
    // Add a brick to the report.
    visBrick = brickGraph.DrawString(s, Color.MidnightBlue, rect, BorderSide.All);

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

    // Preview the report.
    printingSystem1.PreviewFormEx.Show();
vb
Imports DevExpress.XtraPrinting
' ...

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

    ' Specify the string format.
    Dim sFormat As StringFormat = New StringFormat(StringFormatFlags.DirectionVertical)
    sFormat.Alignment = StringAlignment.Center
    sFormat.LineAlignment = StringAlignment.Center

    ' Create the BrickStringFormat object.
    Dim brickSFormat As BrickStringFormat = New BrickStringFormat(sFormat)

    ' Measure the string according to the specified format
    Dim sz As SizeF = brickGraph.MeasureString(s, 30, sFormat)

    ' Start the report generation.
    printingSystem1.Begin()

    ' Set the brick string format
    brickGraph.StringFormat = brickSFormat

    ' Create a rectangle.
    Dim rect As RectangleF = New RectangleF(New PointF(0, 0), New SizeF(30, 150))
    ' Specify a page area.
    brickGraph.Modifier = BrickModifier.Detail
    ' Add a brick to the report.
    visBrick = brickGraph.DrawString(s, Color.MidnightBlue, rect, BorderSide.All)

    ' Finish the report generation.
    printingSystem1.End()

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

The following code snippets (auto-collected from DevExpress Examples) contain references to the StringFormat property.

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.

reporting-printing-library-get-started/CS/Form1.cs#L99

csharp
// Set the line alignment.
    g.StringFormat = g.StringFormat.ChangeLineAlignment(StringAlignment.Near);
}

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

csharp
e.Graph.Font = new Font("Comic Sans MS", 12);
e.Graph.StringFormat = new BrickStringFormat(StringAlignment.Center, StringAlignment.Center);

reporting-printing-library-get-started/VB/Form1.vb#L116

vb
' Set the line alignment.
    g.StringFormat = g.StringFormat.ChangeLineAlignment(StringAlignment.Near)
End If

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

vb
e.Graph.Font = New Font("Comic Sans MS", 12)
e.Graph.StringFormat = New BrickStringFormat(StringAlignment.Center, StringAlignment.Center)

See Also

BrickGraphics Class

BrickGraphics Members

DevExpress.XtraPrinting Namespace