BrickStringFormat.ChangeLineAlignment(StringAlignment) Method

Returns a BrickStringFormat object cloned from the current BrickStringFormat object.

Namespace: DevExpress.XtraPrinting

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

NuGet Package: DevExpress.Printing.Core

Declaration

C#

public BrickStringFormat ChangeLineAlignment(
    StringAlignment newLineAlignment
)

VB.NET

Public Function ChangeLineAlignment(
    newLineAlignment As StringAlignment
) As BrickStringFormat

Parameters

Name	Type	Description
newLineAlignment	StringAlignment	A StringAlignment enumeration value representing line alignment.

Returns

Type	Description
BrickStringFormat	A cloned BrickStringFormat object.

Remarks

This method clones the current BrickStringFormat object and replaces the current value of BrickStringFormat.LineAlignment with the value specified via the parameter.

Example

This example illustrates use of the BrickStringFormat.ChangeAlignment and BrickStringFormat.ChangeLineAlignment methods to change horizontal and vertical alignment of text within the brick. It creates and displays two bricks - the first brick has default settings, the second one has its text alignment modified.

C#

using DevExpress.XtraPrinting;
// ...

    VisualBrick visBrick;
    BrickGraphics brickGraph = printingSystem1.Graph;
    string s = "Developer Express Inc.";
    BrickStringFormat brickSFormat = new BrickStringFormat();

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

    // Specify a page area.
    brickGraph.Modifier = BrickModifier.Detail;

    // Create a rectangle.
    RectangleF rect = new RectangleF(new PointF(0, 0), new SizeF(180, 50));
    // Add a brick to the report.
    visBrick = brickGraph.DrawString(s, Color.MidnightBlue, rect, BorderSide.All);

    // Change the text alignment within the brick
    brickSFormat = visBrick.Style.StringFormat.ChangeAlignment(StringAlignment.Far);
    brickSFormat = brickSFormat.ChangeLineAlignment(StringAlignment.Far);
    brickGraph.StringFormat = brickSFormat;

    // Create a second rectangle.
    RectangleF rect1 = new RectangleF(new PointF(0,50), new SizeF(180, 50));
    // Add the next brick to the report.
    visBrick = brickGraph.DrawString(s, Color.MidnightBlue, rect1, 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."
    Dim brickSFormat As BrickStringFormat = New BrickStringFormat()

    ' Start the report generation.
    printingSystem1.Begin()

    ' Specify a page area.
    brickGraph.Modifier = BrickModifier.Detail

    ' Create a rectangle.
    Dim rect As RectangleF = New RectangleF(New PointF(0, 0), New SizeF(180, 50))
    ' Add a brick to the report.
    visBrick = brickGraph.DrawString(s, Color.MidnightBlue, rect, BorderSide.All)

    ' Change the text alignment within the brick
    brickSFormat = visBrick.Style.StringFormat.ChangeAlignment(StringAlignment.Far)
    brickSFormat = brickSFormat.ChangeLineAlignment(StringAlignment.Far)
    brickGraph.StringFormat = brickSFormat

    ' Create a second rectangle.
    Dim rect1 As RectangleF = New RectangleF(New PointF(0,50), New SizeF(180, 50))
    ' Add the next brick to the report.
    visBrick = brickGraph.DrawString(s, Color.MidnightBlue, rect1, BorderSide.All)

    ' Finish the report generation.
    printingSystem1.End()

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

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ChangeLineAlignment(StringAlignment) 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-printing-library-get-started/CS/Form1.cs#L99

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

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

e.Graph.StringFormat = e.Graph.StringFormat.ChangeAlignment(StringAlignment.Near);
e.Graph.StringFormat = e.Graph.StringFormat.ChangeLineAlignment(StringAlignment.Center);

VB.NET

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

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

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

e.Graph.StringFormat = e.Graph.StringFormat.ChangeAlignment(StringAlignment.Near)
e.Graph.StringFormat = e.Graph.StringFormat.ChangeLineAlignment(StringAlignment.Center)