[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Collapse]Reporting
 [Expand]Product Information
 [Expand]Get Started with DevExpress Reporting
 [Expand]Create Popular Reports
 [Expand]Detailed Guide to DevExpress Reporting
 [Expand]Visual Studio Report Designer
 [Collapse]Create End-User Reporting Applications
   Cross-Platform Reporting
  [Collapse]WinForms Reporting
   [Expand]Print API
   [Expand]Print Preview
   [Collapse]End-User Report Designer
    [Collapse]Quick Start
      Invoke a Default End-User Report Designer Form
      Create a Custom End-User Report Designer
    [Expand]GUI
    [Expand]API and Customization
   [Expand]Application Security
   [Expand]Application Appearance
    Application Deployment
   [Expand]Localization
    End-User Documentation
  [Expand]WPF Reporting
  [Expand]Web Reporting
  [Expand]WCF Report Service
  [Expand]Discontinued Platforms
   Localization
   Redistribution and Deployment
 [Expand]API Reference
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Invoke a Default End-User Report Designer Form

This tutorial illustrates how to open a report in an End-User Report Designer form

Note

You need a Reporting subscription to use the API described in this tutorial.

Expanded Use a Default Design Form

Create a ReportDesignTool class instance with a specified XtraReport (requires referencing the DevExpress.XtraReports.UI namespace) and use any of the following methods to load a report into one of the default End-User Report Designer forms in a WinForms application:

  • Ribbon Report Designer

    The ReportDesignTool.ShowRibbonDesigner and ReportDesignTool.ShowRibbonDesignerDialog methods show a form with a ribbon toolbar.

    Each of these methods has overloads to invoke the Designer form with either the default or custom Look and Feel settings applied.

    The following code illustrates how to call these methods in the main application form's Load event handler:

    To make these methods display the End-User Report Designer form with the previous ribbon version, set the static DesignSettings.UseOfficeInspiredRibbonStyle property to false at the application's startup.

  • Standard Report Designer

    The ReportDesignTool.ShowDesigner and ReportDesignTool.ShowDesignerDialog methods invoke a form with a standard toolbar.

    Both methods have overloads to invoke the Designer form with either the default or custom Look and Feel settings applied.

Tip

See Adding a New Report to a WinForms Application to learn how to add a new XtraReport at design time in the Visual Studio.

Expanded Use a Specific Design Form

The following examples illustrate how you can open a report in a custom Report Designer form:

  • Ribbon Report Designer

    When creating a custom Report Designer derived from the XRDesignRibbonForm class, you can load a report into it via the XRDesignRibbonForm.OpenReport method.

    To show the Report Designer form with the previous ribbon version, disable the static DesignSettings.UseOfficeInspiredRibbonStyle property at the application's startup.

    Note

    The XRDesignRibbonForm is based on the RibbonForm class and using it in your application requires adding the following libraries to the References list of your project:

    • DevExpress.XtraBars.v19.1
    • DevExpress.XtraEditors.v19.1

  • Standard Report Designer

    When creating a custom Report Designer derived from the XRDesignForm class, you can load a report into it via the XRDesignForm.OpenReport method.

Use the XRDesignPanel.Report property to access the report displayed in a Report Designer form. To save that report to a file, use the XRDesignPanel.SaveReport method.

Is this topic helpful?​​​​​​​