WholeRange.AlwaysShowZeroLevel Property

Gets or sets the value that indicates whether to show an axis zero level.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.1.dll

NuGet Package: DevExpress.Charts

Declaration

C#

[NonTestableProperty]
[TypeConverter(typeof(BooleanTypeConverter))]
[XtraSerializableProperty]
public bool AlwaysShowZeroLevel { get; set; }

VB.NET

<TypeConverter(GetType(BooleanTypeConverter))>
<XtraSerializableProperty>
<NonTestableProperty>
Public Property AlwaysShowZeroLevel As Boolean

Property Value

Type	Description
Boolean	true if zero values should be displayed; otherwise false.

Remarks

Use the AlwaysShowZeroLevel property to control whether the zero level should always be visible when the y-axis range is calculated automatically (the Range.Auto property is set to true). The Chart Control calculates a new optimal minimum value for the y-axis when AlwaysShowZeroLevel is disabled. The AlwaysShowZeroLevel property value is ignored if the Range.Auto property is set to false.

Note that you cannot enable the AlwaysShowZeroLevel property for a date-time y-axis.

The following images demonstrate the AlwaysShowZeroLevel property in action:

AlwaysShowZeroLevel = false	AlwaysShowZeroLevel = true

C#

XYDiagram xyDiagram { get { return chartControl1.Diagram as XYDiagram; } }
// ...
xyDiagram.AxisY.WholeRange.AlwaysShowZeroLevel = false;

VB.NET

Private ReadOnly Property xyDiagram As XYDiagram
    Get
        Return CType(chartControl1.Diagram,XYDiagram)
    End Get
End Property
' ...
xyDiagram.AxisY.WholeRange.AlwaysShowZeroLevel = false

Refer to Visual Ranges and Whole Ranges for more information about axis ranges.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the AlwaysShowZeroLevel 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#

winforms-chart-add-a-trend-line/CS/Form1.cs#L48

// Define the Y-axis range.
myView.AxisY.WholeRange.AlwaysShowZeroLevel = false;

xtracharts-how-to-create-a-model-for-a-custom-chart-element/CS/CustomChartElementModel/Form1.cs#L132

diagram.AxisX.WholeRange.SideMarginsValue = 1.2;
diagram.AxisY.WholeRange.AlwaysShowZeroLevel = false;

winforms-charts-create-real-time-chart/CS/RealTimeChartUpdates/Form1.cs#L34

diagram.DependentAxesYRange = DefaultBoolean.True;
diagram.AxisY.WholeRange.AlwaysShowZeroLevel = false;

winforms-charts-create-real-time-chart-and-collect-data-in-separate-thread/CS/RealTimeChartUpdates/Form1.cs#L43

diagram.DependentAxesYRange = DefaultBoolean.True;
diagram.AxisY.WholeRange.AlwaysShowZeroLevel = false;

winforms-charts-create-a-side-by-side-stacked-bars/CS/SideBySideStackedBarChart/Form1.cs#L40

diagram.AxisX.Tickmarks.MinorVisible = false;
diagram.AxisY.WholeRange.AlwaysShowZeroLevel = false;

VB.NET

winforms-chart-add-a-trend-line/VB/Form1.vb#L43

' Define the Y-axis range.
myView.AxisY.WholeRange.AlwaysShowZeroLevel = False
' Add the trendline to the series collection of indicators.

xtracharts-how-to-create-a-model-for-a-custom-chart-element/VB/CustomChartElementModel/Form1.vb#L190

diagram.AxisX.WholeRange.SideMarginsValue = 1.2
diagram.AxisY.WholeRange.AlwaysShowZeroLevel = False
chart.Legend.Visibility = DevExpress.Utils.DefaultBoolean.False

winforms-charts-create-real-time-chart/VB/RealTimeChartUpdates/Form1.vb#L38

diagram.DependentAxesYRange = DefaultBoolean.True
diagram.AxisY.WholeRange.AlwaysShowZeroLevel = False
Dim timer As Timer = New Timer()

winforms-charts-create-real-time-chart-and-collect-data-in-separate-thread/VB/RealTimeChartUpdates/Form1.vb#L53

diagram.DependentAxesYRange = DefaultBoolean.True
diagram.AxisY.WholeRange.AlwaysShowZeroLevel = False
Dim timer As System.Windows.Forms.Timer = New System.Windows.Forms.Timer()

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

diagram.AxisX.Tickmarks.MinorVisible = False
diagram.AxisY.WholeRange.AlwaysShowZeroLevel = False
AddHandler chart.BoundDataChanged, AddressOf Chart_BoundDataChanged