Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

How to: Print a Chart and Show Its Print Preview

  • 2 minutes to read

The following example demonstrates how to print a ChartControl, or show its Print Preview. To do this, you should use either the ChartControl.Print or ChartControl.ShowPrintPreview methods.

Note

A chart can be printed and previewed only if the XtraPrinting Library is available. To verify that printing the chart is possible, use the ChartControl.IsPrintingAvailable property.

When printing a chart, the current print settings will be used to represent a chart. Note that you can access and change these settings via the ChartControl.OptionsPrint property. End-users manually select the printer settings by clicking the Customize toolbar button (PrintPreviewBar.Customize) in a chart’s preview, and setting the required options in the Printable Component Editor.

using DevExpress.XtraCharts;
// ...

private void ShowChartPreview(ChartControl chart) {
    // Check whether the ChartControl can be previewed.
    if (!chart.IsPrintingAvailable) {
        MessageBox.Show("The 'DevExpress.XtraPrinting.v7.2.dll' is not found", "Error");
        return;
    }
    // Open the Preview window.
    chart.ShowPrintPreview();
}

private void PrintChart(ChartControl chart) {
    // Check whether the ChartControl can be printed.
    if (!chart.IsPrintingAvailable) {
        MessageBox.Show("The 'DevExpress.XtraPrinting.v7.2.dll' is not found", "Error");
        return;
    }
    // Print.
    chart.Print();
}

The image below shows the print preview of a ChartControl.

ChartPrinting.psd

Note

If you want to be able to customize different printing options when printing a chart, you need to print it via the PrintableComponentLink component. For more information on using this component, refer to the How to: Use the PrintableComponentLink to Print DevExpress Controls tutorial.