PrintingSystemBase.Begin() Method

Indicates that report generation has started.

Namespace: DevExpress.XtraPrinting

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

NuGet Package: DevExpress.Printing.Core

Declaration

C#

public void Begin()

VB.NET

Public Sub Begin

Remarks

This method signals that report generation has started. All bricks created after calling this method are not included in the report until the PrintingSystemBase.End method is called.

Note

The number of PrintingSystemBase.End method calls must equal the number of Begin method calls.

Example

The following code demonstrates how to create a VisualBrick and specify its dimensions and border settings, using the BrickGraphics.DrawRect method:

C#

using DevExpress.XtraPrinting;
// ...

    VisualBrick visBrick;
    BrickGraphics brickGraph = printingSystem1.Graph;

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

    // Create a rectangle.
    RectangleF rect = new RectangleF(new PointF(0, 0), new SizeF(150, 50));

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

    // Add a brick to the report.
    visBrick = brickGraph.DrawRect(rect, BorderSide.All, Color.Yellow, Color.Blue);

    // 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

    ' Start the report generation.
    printingSystem1.Begin()

    ' Create a rectangle.
    Dim rect As RectangleF = New RectangleF(New PointF(0, 0), New SizeF(150, 50))

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

    ' Add a brick to the report.
    visBrick = brickGraph.DrawRect(rect, BorderSide.All, Color.Yellow, Color.Blue)

    ' 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 Begin() 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-custom-brick/CS/Form1.cs#L18

    "Developer Express Inc.");
printingSystem1.Begin();
// Specify the page area to draw a brick.

VB.NET

reporting-winforms-custom-brick/VB/Form1.vb#L21

                                     "Developer Express Inc.")
printingSystem1.Begin()
' Specify the page area to draw a brick.

reporting-winforms-create-a-non-printable-brick/VB/Form1.vb#L19

' Start the report generation.
printingSystem1.Begin()
' Set the modifier - specify the page area.