MapControl.ShowRibbonPrintPreview() Method

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

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v19.1.dll

Declaration

C#

public void ShowRibbonPrintPreview()

VB.NET

Public Sub ShowRibbonPrintPreview

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.

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 ShowRibbonPrintPreview() 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#L108

case (PrintType.RibbonPreview):
    mapControl.ShowRibbonPrintPreview();
    break;

VB.NET

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

Case (MapControl_PrintingExporting.PrintType.RibbonPreview)
    mapControl.ShowRibbonPrintPreview()
Case (MapControl_PrintingExporting.PrintType.Dialog)