XYDiagram2D.EnableAxisXZooming Property

Specifies whether zooming is allowed for the diagram’s panes along their X-axes.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v23.2.dll

NuGet Package: DevExpress.Charts

Declaration

C#

[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public bool EnableAxisXZooming { get; set; }

VB.NET

<XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)>
Public Property EnableAxisXZooming As Boolean

Property Value

Type	Description
Boolean	true to allow X-axis zooming; otherwise, false.

Remarks

Use the EnableAxisXZooming property to specify whether it’s allowed to zoom the diagram‘s panes along their X-axes, both at design and runtime.

Important

The EnableAxisXZooming property affects on the diagram’s zooming capability only on the WinForms platform. The ASP.NET WebForms Chart Control and MVC Chart Extension do not support this feature.

After you’ve specified the EnableAxisXZooming property, you can individually adjust the capability to zoom the X-axis of each pane, via its XYDiagramPaneBase.EnableAxisXZooming property. And, the default value of the XYDiagramPaneBase.EnableAxisXZooming property means that the actual setting for this pane is obtained from the EnableAxisXZooming property.

At runtime, you can get the actual status for a pane’s X-axis zooming via the read-only XYDiagramPaneBase.ActualEnableAxisXZooming property.

Note

When the EnableAxisXZooming property is enabled, the XYDiagram2D.ZoomingOptions property becomes available, which allows you to choose ways in which zooming can be performed (via the mouse and / or keyboard or using spread or pinch gestures in your touchscreen device).

For the Y-axis, the similar XYDiagram2D.EnableAxisYZooming property is available.

To enable scrolling along the X-axis of the diagram’s panes, use the XYDiagram2D.EnableAxisXScrolling property.

For more information, refer to Zooming and Scrolling (2D XY-Charts).

Example

The following example demonstrates how to create a ChartControl with a series of the LineSeriesView type, and add this chart to a form at runtime. Before proceeding with this example, first create a Windows Forms Application in Visual Studio, and include all necessary assemblies to the References list of your project.

Then, add the following code to the Form.Load event handler.

View Example

C#

using System;
using System.Windows.Forms;
using DevExpress.XtraCharts;
using System.Drawing;
// ...

namespace Series_LineChart {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e) {
            // Create a new chart.
            ChartControl lineChart = new ChartControl();

            // Create a line series.
            Series series1 = new Series("Series 1", ViewType.Line);

            // Add points to it.
            series1.Points.Add(new SeriesPoint(1, 2));
            series1.Points.Add(new SeriesPoint(2, 12));
            series1.Points.Add(new SeriesPoint(3, 14));
            series1.Points.Add(new SeriesPoint(4, 17));

            // Add the series to the chart.
            lineChart.Series.Add(series1);

            // Set the numerical argument scale types for the series,
            // as it is qualitative, by default.
            series1.ArgumentScaleType = ScaleType.Numerical;

            // Access the view-type-specific options of the series.
            ((LineSeriesView)series1.View).MarkerVisibility = DevExpress.Utils.DefaultBoolean.True;
            ((LineSeriesView)series1.View).LineMarkerOptions.Size = 20;
            ((LineSeriesView)series1.View).LineMarkerOptions.Kind = MarkerKind.Triangle;
            ((LineSeriesView)series1.View).LineStyle.DashStyle = DashStyle.Dash;

            // Access the view-type-specific options of the series.
            ((XYDiagram)lineChart.Diagram).AxisY.Interlaced = true;
            ((XYDiagram)lineChart.Diagram).AxisY.InterlacedColor = Color.FromArgb(20, 60, 60, 60);
            ((XYDiagram)lineChart.Diagram).AxisX.NumericScaleOptions.AutoGrid = false;
            ((XYDiagram)lineChart.Diagram).AxisX.NumericScaleOptions.GridSpacing = 1;

            // Hide the legend (if necessary).
            lineChart.Legend.Visibility = DevExpress.Utils.DefaultBoolean.False;

            // Add a title to the chart (if necessary).
            lineChart.Titles.Add(new ChartTitle());
            lineChart.Titles[0].Text = "Line Chart";

            // Add the chart to the form.
            lineChart.Dock = DockStyle.Fill;
            this.Controls.Add(lineChart);
        }
    }
}

VB.NET

Imports System
Imports System.Windows.Forms
Imports DevExpress.XtraCharts
Imports System.Drawing

' ...
Namespace Series_LineChart

    Public Partial Class Form1
        Inherits Form

        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
            ' Create a new chart.
            Dim lineChart As ChartControl = New ChartControl()
            ' Create a line series.
            Dim series1 As Series = New Series("Series 1", ViewType.Line)
            ' Add points to it.
            series1.Points.Add(New SeriesPoint(1, 2))
            series1.Points.Add(New SeriesPoint(2, 12))
            series1.Points.Add(New SeriesPoint(3, 14))
            series1.Points.Add(New SeriesPoint(4, 17))
            ' Add the series to the chart.
            lineChart.Series.Add(series1)
            ' Set the numerical argument scale types for the series,
            ' as it is qualitative, by default.
            series1.ArgumentScaleType = ScaleType.Numerical
            ' Access the view-type-specific options of the series.
            CType(series1.View, LineSeriesView).MarkerVisibility = DevExpress.Utils.DefaultBoolean.True
            CType(series1.View, LineSeriesView).LineMarkerOptions.Size = 20
            CType(series1.View, LineSeriesView).LineMarkerOptions.Kind = MarkerKind.Triangle
            CType(series1.View, LineSeriesView).LineStyle.DashStyle = DashStyle.Dash
            ' Access the view-type-specific options of the series.
            CType(lineChart.Diagram, XYDiagram).AxisY.Interlaced = True
            CType(lineChart.Diagram, XYDiagram).AxisY.InterlacedColor = Color.FromArgb(20, 60, 60, 60)
            CType(lineChart.Diagram, XYDiagram).AxisX.NumericScaleOptions.AutoGrid = False
            CType(lineChart.Diagram, XYDiagram).AxisX.NumericScaleOptions.GridSpacing = 1
            ' Hide the legend (if necessary).
            lineChart.Legend.Visibility = DevExpress.Utils.DefaultBoolean.False
            ' Add a title to the chart (if necessary).
            lineChart.Titles.Add(New ChartTitle())
            lineChart.Titles(0).Text = "Line Chart"
            ' Add the chart to the form.
            lineChart.Dock = DockStyle.Fill
            Me.Controls.Add(lineChart)
        End Sub
    End Class
End Namespace

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the EnableAxisXZooming 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-create-a-drill-down-chart-e1465/CS/Form1.cs#L73

    diagram.EnableAxisXScrolling = false;
    diagram.EnableAxisXZooming = false;
}

VB.NET

how-to-create-a-drill-down-chart-e1465/VB/Form1.vb#L82

    diagram.EnableAxisXScrolling = False
    diagram.EnableAxisXZooming = False
Else

winforms-charts-create-a-side-by-side-stacked-bars/VB/SideBySideStackedBarChart/Form1.vb#L46

' Access the type-specific options of the diagram.
CType(stackedBarChart.Diagram, XYDiagram).EnableAxisXZooming = True
' Hide the legend (if necessary).