Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

DxChartValueAxis.AutoBreaksEnabled Property

Specifies whether to enable auto-calculated scale breaks.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v24.2.dll

NuGet Package: DevExpress.Blazor

#Declaration

C#
[Parameter]
public bool AutoBreaksEnabled { get; set; }

#Property Value

Type Description
Boolean

true to enable auto-calculated scale breaks; otherwise, false.

#Remarks

A scale break is an area across an axis that is shown in place of a section of the axis’ range. It appears across the original axis as a wavy line. Scale breaks allow you to break off parts of the axis to improve the readability of a chart with large differences between high and low values.

The following example shows how you can use the AutoBreaksEnabled property to display scale breaks within the Chart component:

Razor
<DxChart Data="@GetPlanets()">
    <DxChartTitle Text="Planets of the Solar System"></DxChartTitle>
    <DxChartArgumentAxis Type="ChartAxisType.Discrete"></DxChartArgumentAxis>
    <DxChartValueAxis Type="ChartAxisType.Continuous" AutoBreaksEnabled="true">
        <DxChartAxisTitle Text="Mass, kg"></DxChartAxisTitle>
    </DxChartValueAxis>
    <DxChartBarSeries ArgumentField="@((Planet s) => s.Name)" ValueField="@((Planet s) => s.Mass)">
        <DxChartLegend Visible="false"></DxChartLegend>
    </DxChartBarSeries>
</DxChart>

@code {
    List<Planet> GetPlanets() {
        List<Planet> result = new List<Planet>();
        result.Add(new Planet("Mercury", 3.30E23));
        result.Add(new Planet("Venus", 4.87E24)); 
        result.Add(new Planet("Earth", 5.97E24));
        result.Add(new Planet("Mars", 6.42E23)); 
        result.Add(new Planet("Jupiter", 1.90E27));
        result.Add(new Planet("Saturn", 5.68E26));
        result.Add(new Planet("Uranus", 8.68E25)); 
        result.Add(new Planet("Neptune", 1.02E26));
        return result;
    }
    struct Planet {
        public Planet (string name, double mass) { Name = name; Mass = mass; }
        public string Name { get; set; }
        public double Mass { get; set; }
    }
}

No Breaks vs Autobreaks

The MaxAutoBreakCount property allows you to limit the maximum number of auto-created scale breaks if the AutoBreaksEnabled property value is true.

See Also