DashboardDesigner.PrintPreviewShowing Event

Allows you to customize the Print Preview window at runtime.

Namespace: DevExpress.DashboardWin

Assembly: DevExpress.Dashboard.v24.1.Win.dll

NuGet Package: DevExpress.Win.Dashboard

Declaration

C#

public event PrintPreviewShowingEventHandler PrintPreviewShowing

VB.NET

Public Event PrintPreviewShowing As PrintPreviewShowingEventHandler

Event Data

The PrintPreviewShowing event's data class is PrintPreviewShowingEventArgs. The following properties provide information specific to this event:

Property	Description
RibbonPreview	Gets the Print Preview with a ribbon toolbar.
StandardPreview	Gets the Print Preview with a standard toolbar.

Remarks

The PrintPreviewShowing event is raised before the Print Preview window is invoked, and allows you to customize the Print Preview window and the displayed document.

The Print Preview window provides two toolbar types and can be invoked in two ways.

• An end-user clicks the Print Preview button. In this case, the DashboardDesigner.PrintPreviewType property specifies whether a ribbon or standard toolbar is used.
• The DashboardDesigner.ShowPrintPreview/DashboardDesigner.ShowRibbonPrintPreview method is called.

The following event parameters allow you to customize the Print Preview depending on the toolbar used.

• Use the PrintPreviewShowingEventArgs.RibbonPreview event parameter to customize the Print Preview with a ribbon toolbar.
• Use the PrintPreviewShowingEventArgs.StandardPreview event parameter to customize the Print Preview with a standard toolbar.

Important

Note that you can customize the exported document by handling the DashboardDesigner.CustomExport event.

Example

The code snippet below shows how to access the underlying report when handling the DashboardDesigner.PrintPreviewShowing event.

C#

using DevExpress.DashboardWin;

        // ...
        private void dashboardDesigner1_PrintPreviewShowing(object sender, PrintPreviewShowingEventArgs e) {
            ps.SetCommandVisibility(PrintingSystemCommand.ExportXlsx, CommandVisibility.All);
            ps.SetCommandVisibility(PrintingSystemCommand.SendXlsx, CommandVisibility.All);

            ps.SetCommandVisibility(PrintingSystemCommand.Save, CommandVisibility.None);
            ps.SetCommandVisibility(PrintingSystemCommand.Open, CommandVisibility.None);
        }

VB.NET

Imports DevExpress.DashboardWin

        ' ...
        Private Sub dashboardDesigner1_PrintPreviewShowing(ByVal sender As Object, ByVal e As PrintPreviewShowingEventArgs)
            Dim ps As PrintingSystemBase = e.RibbonPreview.PrintControl.PrintingSystem
            ps.SetCommandVisibility(PrintingSystemCommand.ExportXlsx, CommandVisibility.All)
            ps.SetCommandVisibility(PrintingSystemCommand.SendXlsx, CommandVisibility.All)

            ps.SetCommandVisibility(PrintingSystemCommand.Save, CommandVisibility.None)
            ps.SetCommandVisibility(PrintingSystemCommand.Open, CommandVisibility.None)
        End Sub

Implements

PrintPreviewShowing