[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)

Create a Custom End-User Report Designer

Note

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

The Invoke a Default End-User Report Designer Form tutorial illustrates how to open the Report Designer with the Reporting subscription.

This tutorial demonstrates how to add an End-User Report Designer to WinForms applications

Expanded Create a Ribbon Report Designer

Switch to the application's main form in Visual Studio and press CTRL+ALT+X to open the Toolbox. Drop the RibbonReportDesigner component onto the form to create a custom End-User Report Designer with a ribbon UI.

If required, you can hold down the ALT key while dropping this component to add the End-User Report Designer with the previous ribbon version.

Use the XRDesignMdiController.OpenReport method to open a report in the End-User Report Designer.

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 Create a Standard Report Designer

Switch to the application's main form in Visual Studio and press CTRL+ALT+X to open the Toolbox. Drop the StandardReportDesigner component onto the form to create a custom End-User Report Designer with a standard UI.

Use the XRDesignMdiController.OpenReport method to open a report in the End-User Report Designer.

Expanded Visually Inherit from a Designer Form

Another way to create an End-User Report Designer form is to visually inherit it from the XRDesignForm class.

Note

This approach imposes limitations on using the Visual Studio design time - you cannot customize the XRDesignBarManager at design time.

Do the following to create an inherited End-User Report Designer form:

  1. Select PROJECT | Add New Item... in the Visual Studio's main menu and select Inherited Form in the dialog that is invoked.

  2. Click Browse in the invoked Inheritance Picker dialog, and locate the DevExpress.XtraReports.v19.1.Extensions.dll file (it is stored in the "C:\Program Files (x86)\DevExpress 19.1\Components\Bin\Framework" folder by default).

    Select the XRDesignForm or XRDesignRibbonForm class as the base for the created form and click OK.

This adds a custom Report Designer form to your application:

You can now customize the Report Designer form by adding custom code to the created subclass:

Expanded Change the Default Report Settings

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

Use the XRDesignMdiController.DefaultReportSettings property to change the default report settings.

Expanded See Also

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