SeriesBase.Label Property

Gets series label settings.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v21.2.dll


public SeriesLabelBase Label { get; set; }

Property Value

Type Description

A SeriesLabelBase object that provides the series label settings.


The Label property provides access to the settings that specify the appearance, content, and position of series point labels.

Note that you cannot set the Label property. It is available to be set for serialization purposes only.

The label type depends on the series view. The following table lists series views and appropriate label types:


This example demonstrates how to customize the Side-by-Side Bar series label position and appearance.

Use the following API members to customize bar series labels:

Member Description
Series.LabelsVisibility Specifies whether to show labels for a series.
BarSeriesLabel Defines label settings for bar series.
SeriesLabelBase.BackColor Gets or sets the label’s background color.
SeriesLabelBase.Border Gets the label’s border settings.
SeriesLabelBase.Font Gets or sets the font used to display the label’s contents.
BarSeriesLabel.Position Specifies the position of series point labels, relative to their corresponding Bars.
SeriesLabelBase.TextOrientation Specifies the direction of text within the series labels.
SeriesLabelBase.TextPattern Gets or sets a string which represents the pattern specifying the text to be displayed within series labels.
private void OnFormLoad(object sender, EventArgs e) {
    chartControl1.Series[0].LabelsVisibility = DevExpress.Utils.DefaultBoolean.True;

    BarSeriesLabel seriesLabel = chartControl1.Series[0].Label as BarSeriesLabel;
    seriesLabel.BackColor = Color.White;
    seriesLabel.Border.Color = Color.DarkSlateGray;
    seriesLabel.Font = new Font("Tahoma", 10, FontStyle.Regular);
    seriesLabel.Position = BarSeriesLabelPosition.TopInside;
    seriesLabel.TextOrientation = TextOrientation.Horizontal;
    seriesLabel.TextPattern = "{V:F1}";            
See Also