ChartControl.AxisScaleChanged Event

Occurs when the scale mode, measure unit, grid alignment or grid spacing of the axis scale has been changed.

Namespace: DevExpress.XtraCharts

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

Declaration

C#

public event EventHandler<AxisScaleChangedEventArgs> AxisScaleChanged

VB.NET

Public Event AxisScaleChanged As EventHandler(Of AxisScaleChangedEventArgs)

Event Data

The AxisScaleChanged event's data class is AxisScaleChangedEventArgs. The following properties provide information specific to this event:

Property	Description
Axis	Returns the axis whose scale mode, measure unit, grid alignment or grid spacing has been changed.
GridSpacingChange	Returns information about grid spacing changes.
ScaleModeChange	Returns information about scale mode changes.

Remarks

Note that the event args type depends on the current axis scale type. The following table shows dependencies between scale types and argument types.

Scale type	Args type
Qualitative	QualitativeScaleChangedEventArgs
Numeric	NumericScaleChangedEventArgs
Date-Time	DateTimeScaleChangedEventArgs

Example

Use the ChartControl.AxisScaleChanged (WebChartControl.AxisScaleChanged) event to obtain the axis‘ automatically calculated grid alignment and measurement unit values, when the scale mode is automatic. Moreover the event arguments contains the axis itself. This event is raised when the scale mode, measure unit, grid alignment or grid spacing of the axis scale has been changed.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-obtain-values-calculated-for-automatic-axis-date-time-scale-modes-e1529

Form1.cs

private void Form1_Load(object sender, EventArgs e) {
    chartControl1.AxisScaleChanged += OnChartAxisScaleChanged;
}

private void OnChartAxisScaleChanged(object sender, AxisScaleChangedEventArgs e) {
    AxisX axisX = e.Axis as AxisX;
    if (axisX == null) return;
    // In this event, you can access the properties of the corresponding axis, and
    // obtain the automatically calculated value for the axis date-time grid alignment and measure unit.
    axisX.Title.Visibility = DefaultBoolean.True;
    axisX.Title.Text = String.Format(
        "The Axis Grid Alignment Unit is {0} \r\nThe Axis Measure Unit is {1}", 
        e.Axis.DateTimeScaleOptions.GridAlignment.ToString(),
        e.Axis.DateTimeScaleOptions.MeasureUnit.ToString()
    );
}

Form1.vb

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
    AddHandler chartControl1.AxisScaleChanged, AddressOf OnChartAxisScaleChanged
End Sub

Private Sub OnChartAxisScaleChanged(ByVal sender As Object, ByVal e As AxisScaleChangedEventArgs)
    Dim axisX As AxisX = TryCast(e.Axis, AxisX)
    If axisX Is Nothing Then
        Return
    End If
    ' In this event, you can access the properties of the corresponding axis, and
    ' obtain the automatically calculated value for the axis date-time grid alignment and measure unit.
    axisX.Title.Visibility = DefaultBoolean.True
    axisX.Title.Text = String.Format("The Axis Grid Alignment Unit is {0} " & ControlChars.CrLf & "The Axis Measure Unit is {1}", e.Axis.DateTimeScaleOptions.GridAlignment.ToString(), e.Axis.DateTimeScaleOptions.MeasureUnit.ToString())
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the AxisScaleChanged event.

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#

winforms-dashboards-how-to-use-custom-axis-grid-settings-in-the-chart-item-t597206/CS/DesignerSample/Form1.cs#L26

{
    e.ChartControl.AxisScaleChanged += ChartControl_AxisScaleChanged;
}

how-to-obtain-values-calculated-for-automatic-axis-date-time-scale-modes-e1529/CS/MainForm.cs#L13

    this.ordersTableAdapter.Fill(this.nwindDataSet.Orders);
    this.chartControl.AxisScaleChanged += OnAxisScaleChanged;
}

VB.NET

winforms-dashboards-how-to-use-custom-axis-grid-settings-in-the-chart-item-t597206/VB/DesignerSample/Form1.vb#L23

If e.DashboardItemName = "chartDashboardItem1" Then
    AddHandler e.ChartControl.AxisScaleChanged, AddressOf ChartControl_AxisScaleChanged
End If

how-to-obtain-values-calculated-for-automatic-axis-date-time-scale-modes-e1529/VB/MainForm.vb#L15

    Me.ordersTableAdapter.Fill(Me.nwindDataSet.Orders)
    AddHandler Me.chartControl.AxisScaleChanged, AddressOf OnAxisScaleChanged
End Sub