MapControl.ShowPrintDialog() Method

Displays the standard Print dialog to print the data displayed in the MapControl.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v19.1.dll

Declaration

C#

public void ShowPrintDialog()

VB.NET

Public Sub ShowPrintDialog

Remarks

The Print dialog allows you to select a printer and its settings, and then start or cancel the print operation.

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.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-print-or-export-a-map-t185956

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

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ShowPrintDialog() 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-print-or-export-a-map-t185956/CS/MapControl_PrintingExporting/Form1.cs#L111

case (PrintType.Dialog):
    mapControl.ShowPrintDialog();
    break;

VB.NET

how-to-print-or-export-a-map-t185956/VB/MapControl_PrintingExporting/Form1.vb#L115

    Case (MapControl_PrintingExporting.PrintType.Dialog)
        mapControl.ShowPrintDialog()
End Select