MapControl.ShowPrintPreview() Method

Invokes the Print Preview Form, which shows the print preview of the map control.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v24.1.dll

NuGet Package: DevExpress.Win.Map

Declaration

C#

public void ShowPrintPreview()

VB.NET

Public Sub ShowPrintPreview

Remarks

The Print Preview form displays the map as it will appear when printed. To print the map, use the MapControl.Print method and to export it, use the appropriate ExportTo~ method (e.g., MapControl.ExportToPdf, etc.)

Note

The map control can be previewed, printed or exported only if the XtraPrinting Library is available.

Example

To print a map, use one of the following methods.

• MapControl.ShowPrintPreview - invokes the Print Preview Form;
• MapControl.ShowRibbonPrintPreview - invokes the Print Preview Form with the Ribbon bar;
• MapControl.ShowPrintDialog - invokes the standard Print Dialog.

Form1.cs

private void ddbPrint_Click(object sender, EventArgs e) {
    switch (printType) {
        case (PrintType.Preview):
            mapControl.ShowPrintPreview();
            break;
        case (PrintType.RibbonPreview):
            mapControl.ShowRibbonPrintPreview();
            break;
        case (PrintType.Dialog):
            mapControl.ShowPrintDialog();
            break;
    }
}

Form1.vb

Private Sub ddbPrint_Click(ByVal sender As Object, ByVal e As EventArgs) Handles ddbPrint.Click
    Select Case printType
        Case (MapControl_PrintingExporting.PrintType.Preview)
            mapControl.ShowPrintPreview()
        Case (MapControl_PrintingExporting.PrintType.RibbonPreview)
            mapControl.ShowRibbonPrintPreview()
        Case (MapControl_PrintingExporting.PrintType.Dialog)
            mapControl.ShowPrintDialog()
    End Select
End Sub