XtraReportPreviewExtensions.ShowRibbonPreviewDialog(IReport, UserLookAndFeel) Method

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

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraPrinting.v20.2.dll

Declaration

public static void ShowRibbonPreviewDialog(
    this IReport report,
    UserLookAndFeel lookAndFeel
)
<ExtensionAttribute>
Public Shared Sub ShowRibbonPreviewDialog(
    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 ShowRibbonPreviewDialog method to open the report in the default Print Preview form with a Standard Toolbar modally.

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

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

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

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

We recommend you use the ReportPrintTool class instead, which provides the similar PrintTool.ShowRibbonPreviewDialog 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 ShowRibbonPreviewDialog method in Web applications. Use the Web Document Viewer instead.

See Also