DashboardViewer.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
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.
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);
}