Back to Devexpress

XRDesignMdiController.DefaultReportSettings Property

xtrareports-devexpress-dot-xtrareports-dot-userdesigner-dot-xrdesignmdicontroller.md

latest6.4 KB
Original Source

XRDesignMdiController.DefaultReportSettings Property

Provides access to the default report settings.

Namespace : DevExpress.XtraReports.UserDesigner

Assembly : DevExpress.XtraReports.v25.2.Extensions.dll

NuGet Package : DevExpress.Win.Reporting

Declaration

csharp
public ReportSettings DefaultReportSettings { get; }
vb
Public ReadOnly Property DefaultReportSettings As ReportSettings

Property Value

TypeDescription
ReportSettings

Report page settings.

|

Remarks

The StandardReportDesigner and RibbonReportDesigner components use the following default settings to create new reports:

Use the DefaultReportSettings property to change the default report settings.

Change Default Report Settings at Design Time

When you drop a StandardReportDesigner or RibbonReportDesigner component to your form, a XRDesignMdiController item appears on your form called reportDesigner1.

Click reportDesigner1 and switch to the Properties window. Expand the DefaultReportSettings group.

You can change the default settings for report. Reports created in End-User Designer copy their report settings from the DefaultReportSettings object.

Change Default Report Settings at Runtime

The following code sample illustrates how to create an End-User Designer instance and specify default report settings.

The following code sample creates an End-User Designer instance and specifies default settings for its reports:

csharp
using DevExpress.XtraReports.UI;
using DevExpress.Drawing.Printing;
using DevExpress.XtraReports.UserDesigner;
// ...
XRDesignForm form = new XRDesignForm();
XRDesignMdiController reportDesigner = form.DesignMdiController;
// Report Page Settings
reportDesigner.DefaultReportSettings.PaperKind = DXPaperKind.Letter;
reportDesigner.DefaultReportSettings.Landscape = true;
reportDesigner.DefaultReportSettings.RollPaper = false;
reportDesigner.DefaultReportSettings.ReportUnit = ReportUnit.HundredthsOfAnInch;
reportDesigner.DefaultReportSettings.Margins = new System.Drawing.Printing.Margins(50, 50, 100, 100);
// Report Font Settings
reportDesigner1.DefaultReportSettings.Font = new DevExpress.Drawing.DXFont("Arial", 12f);
// Report Export Settings
reportDesigner.DefaultReportSettings.ExportSettings.FileName = "TestReport";
reportDesigner.DefaultReportSettings.ExportSettings.ExportFormat = DevExpress.XtraPrinting.ExportFormat.Xlsx;
// Report Layout Settings
reportDesigner.DefaultReportSettings.DesignerSettings.DrawGrid = false;
reportDesigner.DefaultReportSettings.DesignerSettings.SnappingMode = DevExpress.XtraReports.UI.SnappingMode.SnapToGridAndSnapLines;
form.ShowDialog();
vb
Imports DevExpress.XtraReports.UI
Imports DevExpress.Drawing.Printing
Imports DevExpress.XtraReports.UserDesigner
' ...
Private form As New XRDesignForm()
Private reportDesigner As XRDesignMdiController = form.DesignMdiController
' Report Page Settings
reportDesigner.DefaultReportSettings.PaperKind = DXPaperKind.Letter
reportDesigner.DefaultReportSettings.Landscape = True
reportDesigner.DefaultReportSettings.RollPaper = False
reportDesigner.DefaultReportSettings.ReportUnit = ReportUnit.HundredthsOfAnInch
reportDesigner.DefaultReportSettings.Margins = New System.Drawing.Printing.Margins(50, 50, 100, 100)
' Report Font Settings
reportDesigner1.DefaultReportSettings.Font = New DevExpress.Drawing.DXFont("Arial", 12F)
' Report Export Settings
reportDesigner.DefaultReportSettings.ExportSettings.FileName = "TestReport"
reportDesigner.DefaultReportSettings.ExportSettings.ExportFormat = DevExpress.XtraPrinting.ExportFormat.Xlsx
' Report Layout Settings
reportDesigner.DefaultReportSettings.DesignerSettings.DrawGrid = False
reportDesigner.DefaultReportSettings.DesignerSettings.SnappingMode = DevExpress.XtraReports.UI.SnappingMode.SnapToGridAndSnapLines
form.ShowDialog()

See Also

XRDesignMdiController Class

XRDesignMdiController Members

DevExpress.XtraReports.UserDesigner Namespace