Skip to main content
All docs
V26.1
  • XRDesignMdiController.DefaultReportSettings Property

    Provides access to the default report settings.

    Namespace: DevExpress.XtraReports.UserDesigner

    Assembly: DevExpress.XtraReports.v26.1.Extensions.dll

    NuGet Package: DevExpress.Win.Reporting

    Declaration

    public ReportSettings DefaultReportSettings { get; }

    Property Value

    Type Description
    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.

    ShowExportWarnings

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

    ShowExportWarnings

    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:

    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();
    
    See Also