ChartOptionsPrint Class

Provides print options for the chart control.

Namespace: DevExpress.XtraCharts.Printing

Assembly: DevExpress.XtraCharts.v19.2.dll

Declaration

public class ChartOptionsPrint :
    BaseOptions,
    IXtraSupportShouldSerialize
Public Class ChartOptionsPrint
    Inherits BaseOptions
    Implements IXtraSupportShouldSerialize

Remarks

The ChartOptionsPrint class provides a set of properties that control how the chart is printed. These properties can be accessed via the control's ChartControl.OptionsPrint property.

Examples

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();
}

Inheritance

See Also