XtraReportPreviewExtensions.ShowRibbonPreview(IReport, UserLookAndFeel) Method

Opens the report document in the ribbon-based Print Preview form with the specified look and feel settings.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraPrinting.v23.2.dll

NuGet Packages: DevExpress.Win.Navigation, DevExpress.Win.Printing

Declaration

C#

public static void ShowRibbonPreview(
    this IReport report,
    UserLookAndFeel lookAndFeel
)

VB.NET

<ExtensionAttribute>
Public Shared Sub ShowRibbonPreview(
    report As IReport,
    lookAndFeel As UserLookAndFeel
)

Parameters

Name	Type	Description
report	IReport	An object implementing the IReport interface.
lookAndFeel	UserLookAndFeel	A UserLookAndFeel object which specifies the look and feel settings applied to Print Preview.

Remarks

Call the ShowRibbonPreview method to open the report in the default Print Preview form with a Ribbon Toolbar.

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

The following example demonstrates how to invoke Print Preview with custom look and feel settings.

C#

using DevExpress.XtraReports.UI;
// ...

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

VB.NET

Imports DevExpress.XtraReports.UI
' ...

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

We recommend you use the ReportPrintTool class instead, which provides the similar PrintTool.ShowRibbonPreview method and additionally allows you to customize the Print Preivew 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 ShowRibbonPreview method in Web applications. Use the Web Document Viewer instead.