PivotGridControl.ShowPrintPreview() Method

Opens the Print Preview window with a toolbar-based interface.

Namespace: DevExpress.XtraPivotGrid

Assembly: DevExpress.XtraPivotGrid.v24.2.dll

Declaration

C#

public void ShowPrintPreview()

VB.NET

Public Sub ShowPrintPreview

Remarks

The Preview window displays the pivot grid as it will appear when it is printed. Pivot Grid Control can be previewed and printed if the XtraPrinting Library is available. To ensure that printing and previewing Pivot Grid Control is allowed, use the PivotGridControl.IsPrintingAvailable property.

To open the Print Preview window with a Ribbon-based interface, use the PivotGridControl.ShowRibbonPrintPreview method.

Example

The following example demonstrates how to print the Pivot Grid control using the PivotGridControl.Print method and show its Print Preview window using the PivotGridControl.ShowPrintPreview method.

Note

Printing functionality depends on the DevExpress.XtraPrinting library. To verify that the library is available, use the PivotGridControl.IsPrintingAvailable property.

You can access print settings and modify them using the PivotGridControl.OptionsPrint property.

C#

using DevExpress.XtraPivotGrid;
// ...

private void ShowPivotGridPreview(PivotGridControl pivotGrid) {
    // Verify that the Pivot Grid Control can be printed.
    if (!pivotGrid.IsPrintingAvailable) {
        MessageBox.Show("Missing DevExpress.XtraPrinting library", "Error");
        return;
    }
    pivotGrid.ShowPrintPreview();
}

private void PrintPivotGrid(PivotGridControl pivotGrid) {
    // Verify that the Pivot Grid Control can be printed.
    if (!pivotGrid.IsPrintingAvailable) {
        MessageBox.Show("Missing DevExpress.XtraPrinting library", "Error");
        return;
    }
    pivotGrid.Print();
});
}

VB.NET

Imports DevExpress.XtraPivotGrid
' ...

Sub ShowPivotGridPreview(ByVal pivotGrid As PivotGridControl)
   ' Verify that the Pivot Grid Control can be printed.
   If Not pivotGrid.IsPrintingAvailable Then
        MessageBox.Show("Missing DevExpress.XtraPrinting library", "Error");
      Return
   End If
   pivotGrid.ShowPrintPreview()
End Sub

Sub PrintPivotGrid(ByVal pivotGrid As PivotGridControl)
   ' Verify that the Pivot Grid Control can be printed.
   If Not pivotGrid.IsPrintingAvailable Then
        MessageBox.Show("Missing DevExpress.XtraPrinting library", "Error");
      Return
   End If
   pivotGrid.Print()
End Sub