Skip to main content

ChartControlBase.ShowPrintPreview(FrameworkElement, String, String, PrintSizeMode) Method

Creates a print document with the specified name from a chart with the specified print size mode and displays the document using the Print Preview window with the specified owner and title.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v24.1.dll

NuGet Package: DevExpress.Wpf.Charts

Declaration

public void ShowPrintPreview(
    FrameworkElement owner,
    string documentName,
    string title,
    PrintSizeMode sizeMode
)

Parameters

Name Type Description
owner FrameworkElement

The Print Preview owner.

documentName String

The name which should be used for the document to be displayed in the Print Preview.

title String

The Print Preview title.

sizeMode PrintSizeMode

The size mode which must be used when the chart control is previewed before printing.

Remarks

To print the document immediately without invoking any dialogs, use the ChartControlBase.PrintDirect method.

To show the standard Print dialog, use the ChartControlBase.Print method. The dialog allows end-users to print the chart, select the printer (if required), specify the range of pages to print, the number of copies, etc.

To export the chart, use the appropriate ExportTo~ method (e.g., ChartControlBase.ExportToHtml, ChartControlBase.ExportToPdf, etc.)

Important

The chart can be previewed, printed and exported only if the DXPrinting Library is available. Make sure you add a reference to the DevExpress.Xpf.Printing.v24.1 assembly.

Methods that allow you to show Print Preview with other preview settings.

Name Description
ChartControlBase.ShowPrintPreviewDialog Creates the print document and displays the Print Preview of the document as a modal window.
ChartControlBase.ShowRibbonPrintPreview Creates the print document and displays the Print Preview with the Ribbon toolbar of the document.
ChartControlBase.ShowRibbonPrintPreviewDialog Creates the print document and displays the Print Preview with the Ribbon toolbar of the document as a modal window.
See Also