SideBySideStackedBar3DSeriesView.BarDistance Property

Specifies the distance between two bars of different series shown at the same axis value, as a fraction of axis units.

Namespace : DevExpress.XtraCharts

Assembly : DevExpress.XtraCharts.v25.2.dll

NuGet Package : DevExpress.Charts

Declaration

C#
VB.NET

csharp

[XtraChartsLocalizableCategory(XtraChartsCategory.Layout)]
public double BarDistance { get; set; }

<XtraChartsLocalizableCategory(XtraChartsCategory.Layout)>
Public Property BarDistance As Double

Property Value

Type	Description
Double

A Double value that represents the distance between two neighboring bars, as a fraction of axis units.

Remarks

The BarDistance property specifies the distance between two bars in a Side-by-Side Stacked Bar series, as a fraction of axis units (the distance between two major axis tickmarks). This means that the distance is being auto-adjusted when the chart is resized. For example, if the BarDistance property is set to 0.5 , the distance between the two bars will be always equal to half the range between the two major values on the axis.

To specify this distance in pixels, use the SideBySideStackedBar3DSeriesView.BarDistanceFixed property. If the BarDistance and SideBySideStackedBar3DSeriesView.BarDistanceFixed properties are in effect simultaneously, their values are accumulated together, expressing constant and variable distances.

Note

The BarDistance property is synchronized in all Side-by-Side Stacked Bars, present in a ChartControl, and all of them always return the same value. So, changing the BarDistance property for any such series, affects the BarDistance property value in all other similar series.

For the same reason, when trying to set the BarDistance property before a Series is added to a chart’s collection, an ArgumentException is thrown.