DashboardViewer.PrintPreviewShowing Event

Allows you to customize the Print Preview window at runtime.

Namespace: DevExpress.DashboardWin

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

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 DashboardViewer.PrintPreviewType property specifies whether a ribbon or standard toolbar is used.
• The DashboardViewer.ShowPrintPreview/DashboardViewer.ShowRibbonPrintPreview method is called.

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

• 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 DashboardViewer.CustomExport event.

Example

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

C#

using DevExpress.DashboardWin;

        // ...
        private void dashboardViewer1_PrintPreviewShowing(object sender, PrintPreviewShowingEventArgs e) {
            PrintingSystemBase ps = 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);
        }

VB.NET

Imports DevExpress.DashboardWin

        ' ...
        Private Sub dashboardViewer1_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