Printing and Exporting

• Oct 29, 2020
• 4 minutes to read

The Map control allows you to print and export a map and its vector layer items to multiple formats.

Make sure that your project references the DevExpress.XtraPrinting.25.2 and DevExpress.Printing.v25.2.Core assemblies to be capable of completing the following tasks.

• Immediately Print a Map
• Print a Map Using the Standard Print Dialog
• Print/Export a Map Using the Print Preview
• Export a Map from Code
• Configure Print/Export Options

Immediately Print a Map

To immediately print the Map control’s content without invoking any print dialogs, use the MapControl.Print method.

• C#
• VB.NET

private void onButtonClick(object sender, EventArgs e) {
        mapControl.Print();
}

Private Sub onButtonClick(sender As Object, e As EventArgs)
        mapControl.Print()
End Sub

Print a Map Using the Standard Print Dialog

You can show the standard print dialog before map printing as the following image demonstrates.

To show the default print dialog before printing, use the MapControl.ShowPrintDialog method.

• C#
• VB.NET

private void onButtonClick(object sender, EventArgs e) {
        mapControl.ShowPrintDialog();
}

Private Sub onButtonClick(sender As Object, e As EventArgs)
    mapControl.ShowPrintDialog()
End Sub

Print/Export a Map Using the Print Preview

To show the Print Preview dialog with a toolbox or with a Ribbon, use one of the following methods.

The code below shows how to invoke the Ribbon Print Preview.

• C#
• VB.NET

private void onButtonClick(object sender, RoutedEventArgs e) {
      mapControl.ShowRibbonPrintPreview(this);
}

Private Sub onButtonClick(sender As Object, e As RoutedEventArgs)
    mapControl.ShowRibbonPrintPreview(Me)
End Sub

To immediately print a map using the Print Preview, select the Quick Print item.

The Print Preview

The Ribbon Print Preview

To invoke the standard print dialog before printing, select the Print item in the Print Preview.

The Print Preview

The Ribbon Print Preview

To export a map using the Print Preview dialog, select the desired file format in the Export item’s drop-down list.

The Print Preview

The Ribbon Print Preview

Export a Map from Code

All the map data can be exported to numerous file formats. For this, use the appropriate method from the table below.

The following code shows how to export a map to the specified PDF file.

• C#
• VB.NET

private void onButtonClick(object sender, EventArgs e) {
        mapControl.ExportToPdf("D://document.pdf");
}

Private Sub onButtonClick(sender As Object, e As EventArgs)
    mapControl.ExportToPdf("D://document.pdf")
End Sub

In addition, you can export a map vector layer‘s content to one of the supported formats using the following methods.

Use the following code to export map vector data to the specified KML file.

• C#
• VB.NET

private void onButtonClick(object sender, EventArgs e) {
        vectorLayer.ExportToKml("D://file.kml");
}

Private Sub onButtonClick(sender As Object, e As EventArgs)
    vectorLayer.ExportToKml("D://file.kml")
End Sub

Configure Print/Export Option

To configure printing/exporting options, you can use the following code example.

• C#
• VB.NET

private void onButtonClick(object sender, EventArgs e) {
    mapControl.PrintOptions.PrintMiniMap = true;
    mapControl.PrintOptions.PrintNavigationPanel = true;
    mapControl.PrintOptions.PrintOverlays = true;
    mapControl.PrintOptions.SizeMode = MapPrintSizeMode.Zoom;
    mapControl.Print();            
}

Private Sub onButtonClick(sender As Object, e As EventArgs)
    mapControl.PrintOptions.PrintMiniMap = True
    mapControl.PrintOptions.PrintNavigationPanel = True
    mapControl.PrintOptions.PrintOverlays = True
    mapControl.PrintOptions.SizeMode = MapPrintSizeMode.Zoom
    mapControl.Print()
End Sub

The code above uses the following API members.

See Also

How to: Print a Map

How to: Export a Map

How to: Export Selected Map Items to an Image

Document Viewer