ChartPrinter.SizeMode Property

Specifies the printing size mode for the chart control.

Namespace: DevExpress.XtraCharts.Printing

Assembly: DevExpress.XtraCharts.v18.2.dll

Declaration

C#

public PrintSizeMode SizeMode { get; set; }

VB.NET

Public Property SizeMode As PrintSizeMode

Property Value

Type	Description
PrintSizeMode	A PrintSizeMode enumeration value, representing the chart’s size mode.

Available values:

Name	Description
None	A chart is printed with its size identical to that shown on the form.
Stretch	A chart is stretched or shrunk to fit the page on which it is printed.
Zoom	A chart is resized proportionally (without clipping), so that it best fits the page on which it is printed.

Example

This example demonstrates how to specify the printing settings of a chart (to fit its size to the page width), using the ChartPrinter class.

C#

using System;
using System.Windows.Forms;
using DevExpress.XtraPrinting;
using DevExpress.XtraCharts.Printing;
// ...

ChartPrinter cp;

private void button1_Click(object sender, EventArgs e) {
    Link l = new Link(new PrintingSystem());
    l.Landscape = true;
    l.PaperKind = System.Drawing.Printing.PaperKind.A3;
    cp = new ChartPrinter(this.chartControl1);
    cp.Initialize(l.PrintingSystem, l);
    cp.SizeMode = PrintSizeMode.Stretch;
    l.CreateDetailArea += new CreateAreaEventHandler(l_CreateDetailArea);
    l.ShowPreviewDialog();
    cp.Release();
}

void l_CreateDetailArea(object sender, CreateAreaEventArgs e) {
    cp.CreateDetail(e.Graph);
}

VB.NET

Imports System
Imports System.Windows.Forms
Imports DevExpress.XtraPrinting
Imports DevExpress.XtraCharts.Printing
' ...
Private cp As ChartPrinter

Private Sub button1_Click(ByVal sender As Object, _ 
ByVal e As EventArgs) Handles button1.Click
    Dim l As New Link(New PrintingSystem())
    l.Landscape = True
    l.PaperKind = System.Drawing.Printing.PaperKind.A3
    cp = New ChartPrinter(Me.chartControl1)
    cp.Initialize(l.PrintingSystem, l)
    cp.SizeMode = PrintSizeMode.Stretch
    AddHandler l.CreateDetailArea, AddressOf l_CreateDetailArea
    l.ShowPreviewDialog()
    cp.Release()
End Sub

Private Sub l_CreateDetailArea(ByVal sender As Object, _ 
ByVal e As CreateAreaEventArgs)
    cp.CreateDetail(e.Graph)
End Sub

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the SizeMode property.

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-fit-the-size-of-a-chart-to-the-page-width-in-the-print-preview-e2031/CS/PrintTheChart/Form1.cs#L21

cp.Initialize(l.PrintingSystem, l);
cp.SizeMode = PrintSizeMode.Stretch;
l.CreateDetailArea += new CreateAreaEventHandler(l_CreateDetailArea);

VB.NET

how-to-fit-the-size-of-a-chart-to-the-page-width-in-the-print-preview-e2031/VB/PrintTheChart/Form1.vb#L23

cp.Initialize(l.PrintingSystem, l)
cp.SizeMode = PrintSizeMode.Stretch
AddHandler l.CreateDetailArea, AddressOf l_CreateDetailArea