Back to Devexpress

ChartControl.Print() Method

windowsforms-devexpress-dot-xtracharts-dot-chartcontrol-eafff000.md

latest3.9 KB
Original Source

ChartControl.Print() Method

Prints the chart.

Namespace : DevExpress.XtraCharts

Assembly : DevExpress.XtraCharts.v25.2.UI.dll

NuGet Package : DevExpress.Win.Charts

Declaration

csharp
public void Print()
vb
Public Sub Print

Remarks

Use this method to print the chart using current printing settings. The current printing settings are specified by the ChartControl.OptionsPrint property of the chart.

To verify that the chart can be printed, check the ChartControl.IsPrintingAvailable property’s value.

Example

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 ( ) in a chart’s preview, and setting the required options in the Printable Component Editor.

csharp
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();
}
vb
Imports DevExpress.XtraCharts
' ...

Sub ShowChartPreview(ByVal chart As ChartControl)
   ' Check whether the ChartControl can be previewed.
   If Not chart.IsPrintingAvailable Then
      MessageBox.Show("The 'DevExpress.XtraPrinting.v7.2.dll' is not found", "Error")
      Return
   End If

   ' Opens the Preview window.
   chart.ShowPrintPreview()
End Sub

Sub PrintChart(ByVal chart As ChartControl)
   ' Check whether the ChartControl can be printed.
   If Not chart.IsPrintingAvailable Then
      MessageBox.Show("The 'DevExpress.XtraPrinting.v7.2.dll' is not found", "Error")
      Return
   End If

   ' Print.
   chart.Print()
End Sub

See Also

ShowPrintPreview

IsPrintingAvailable

ChartControl Class

ChartControl Members

DevExpress.XtraCharts Namespace