ChartControlBase.ShowPrintPreviewDialog(Window, 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 modal 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

C#

public void ShowPrintPreviewDialog(
    Window owner,
    string documentName,
    string title,
    PrintSizeMode sizeMode
)

VB.NET

Public Sub ShowPrintPreviewDialog(
    owner As Window,
    documentName As String,
    title As String,
    sizeMode As PrintSizeMode
)

Parameters

Name	Type	Description
owner	Window	The print preview owner.
documentName	String	A String value specifying what name should be used for the document to be displayed in the Print Preview.
title	String	The title of the Print Preview.
sizeMode	PrintSizeMode	The size mode which the chart must use when the chart control is printed.

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.ShowPrintPreview	Creates a print document and displays the Print Preview of the document.
ChartControlBase.ShowRibbonPrintPreview	Creates a print document and displays the Print Preview with the Ribbon toolbar of the document.
ChartControlBase.ShowRibbonPrintPreviewDialog	Creates a print document and displays the Print Preview with the Ribbon toolbar of the document as a modal window.