PrintableComponentLink.ShowPreviewDialog(IWin32Window) Method

Invokes the Print Preview Form, which modally shows the print preview of the document for this link as a child of the specified parent window.

Namespace: DevExpress.XtraPrinting

Assembly: DevExpress.XtraPrinting.v20.2.dll

NuGet Package: DevExpress.Win.Printing

Declaration

C#

public virtual void ShowPreviewDialog(
    IWin32Window owner
)

VB.NET

Public Overridable Sub ShowPreviewDialog(
    owner As IWin32Window
)

Parameters

Name	Type	Description
owner	IWin32Window	A IWin32Window object representing the parent window for this dialog.

Remarks

Use the ShowPreviewDialog method to invoke the PrintPreviewFormEx form and show the print preview of the document created for this link. Note that if the link’s document hasn’t been created (the PrintableComponentLink.CreateDocument method hasn’t been called for it), then calling the ShowPreviewDialog method will create it first.

Consequently, if a document was created prior to calling the ShowPreviewDialog method, and nothing was changed that may force its re-creation, the ShowPreviewDialog method doesn’t re-create it, so you need to manually call the PrintableComponentLink.CreateDocument method, if required.

For more information, refer to Document Viewer and Document Viewer Toolbars.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ShowPreviewDialog(IWin32Window) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-store-page-settings-between-print-previews-e936/CS/Form1.cs#L31

link.ShowPreviewDialog(this);

VB.NET

how-to-store-page-settings-between-print-previews-e936/VB/Form1.vb#L28

link.Margins = pageSettings.Margins
link.ShowPreviewDialog(Me)
Dim pivotSettings As PivotGridPageSettings = pivotGridControl1.OptionsPrint.PageSettings