XtraReportDesignerExtensions.ShowRibbonDesignerDialog(XtraReport, UserLookAndFeel) Method

Invokes the ribbon-based End-User Report Designer form modally with the specified look and feel settings to allow end-users to edit the report.

Namespace : DevExpress.XtraReports.UI

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

NuGet Package : DevExpress.Win.Reporting

csharp

public static void ShowRibbonDesignerDialog(
    this XtraReport report,
    UserLookAndFeel lookAndFeel
)

<ExtensionAttribute>
Public Shared Sub ShowRibbonDesignerDialog(
    report As XtraReport,
    lookAndFeel As UserLookAndFeel
)

Parameters

Name	Type	Description
report	XtraReport

A report to open in the End-User Report Designer.

| | lookAndFeel | UserLookAndFeel |

A UserLookAndFeel object which specifies the look and feel settings applied to the End-User Report Designer.

Remarks

Call the ShowRibbonDesignerDialog method to open the report in the default Report Designer form with a Ribbon Toolbar modally.

To be able to use this method, you should add the DevExpress.XtraReports.v25.2.Extensions.dll to your project’s References list.

The following example demonstrates how to invoke the Report Designer modally with custom look and feel settings.

C#
VB.NET

csharp

using DevExpress.XtraReports.UI;
using DevExpress.LookAndFeel;
using DevExpress.XtraReports.UserDesigner;
// ...

XtraReport1 report = new XtraReport1();
UserLookAndFeel myLookAndFeel = new UserLookAndFeel(report);
myLookAndFeel.SkinName = "Office 2016 Colorful";
myLookAndFeel.UseDefaultLookAndFeel = false;
report.ShowRibbonDesignerDialog(myLookAndFeel);

Imports DevExpress.XtraReports.UI
Imports DevExpress.LookAndFeel
Imports DevExpress.XtraReports.UserDesigner
' ...

Dim report As XtraReport1 = New XtraReport1
Dim myLookAndFeel As UserLookAndFeel = New UserLookAndFeel(report)
myLookAndFeel.SkinName = "Office 2016 Colorful"
myLookAndFeel.UseDefaultLookAndFeel = false
report.ShowRibbonDesignerDialog(myLookAndFeel)

We recommend you use the ReportDesignTool class instead, which provides the similar ReportDesignTool.ShowRibbonDesignerDialog method and additionally allows you to customize the Report Designer form. This class also enables you to release the memory right after showing this form (for instance, by calling the Dispose method or utilizing the using statement).

Note

You cannot use the ShowRibbonDesignerDialog method in Web applications. Use the Web Report Designer instead.