Skip to main content

BarSeriesLabel.ShowForZeroValues Property

Gets or sets a value indicating whether to show series labels if a bar’s height is zero.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.1.dll

NuGet Package: DevExpress.Charts

Declaration

[TypeConverter(typeof(BooleanTypeConverter))]
[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
[XtraSerializableProperty]
public bool ShowForZeroValues { get; set; }

Property Value

Type Description
Boolean

true to show labels of zero-height bars; otherwise, false.

Remarks

Use the ShowForZeroValues property to control whether you want the series labels to be visible only for visible bars, or you need to additionally show labels for bars with a zero height, which are actually invisible on a chart. This may be required to make it easier to understand whether there is a bar or not.

The following images demonstrate the ShowForZeroValues property in action.

ShowForZeroValues = true ShowForZeroValues = false
showForZeroValues_true showForZeroValues_false

For more information, refer to Series Point Labels and Empty Points Representation.

Example

This example demonstrates the capability to show or hide series labels for empty series points of a Bar series.

((BarSeriesLabel)series1.Label).ShowForZeroValues = true;
See Also