SeriesBase.Label Property

Gets series label settings.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v20.1.dll

Declaration

[XtraChartsLocalizableCategory(XtraChartsCategory.Elements)]
public SeriesLabelBase Label { get; set; }
<XtraChartsLocalizableCategory(XtraChartsCategory.Elements)>
Public Property Label As SeriesLabelBase

Property Value

Type Description
SeriesLabelBase

A SeriesLabelBase object that provides the series label settings.

Remarks

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:

Examples

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