Back to Devexpress

SeriesLabelBase.TextOrientation Property

corelibraries-devexpress-dot-xtracharts-dot-serieslabelbase-44d0e430.md

latest6.0 KB
Original Source

SeriesLabelBase.TextOrientation Property

Specifies the direction of text within the series labels.

Namespace : DevExpress.XtraCharts

Assembly : DevExpress.XtraCharts.v25.2.dll

NuGet Package : DevExpress.Charts

Declaration

csharp
[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public virtual TextOrientation TextOrientation { get; set; }
vb
<XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)>
Public Overridable Property TextOrientation As TextOrientation

Property Value

TypeDescription
TextOrientation

A TextOrientation enumeration value that specifies the text direction for the series labels.

|

Available values:

NameDescription
Horizontal

The series labels are not rotated.

| | TopToBottom |

The series labels are rotated vertically, clockwise.

| | BottomToTop |

The series labels are rotated vertically, counterclockwise.

|

Remarks

The following images demonstrate the TextOrientation property in action.

TextOrientation = HorizontalTextOrientation = TopToBottomTextOrientation = BottomToTop

Example

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:

MemberDescription
Series.LabelsVisibilitySpecifies whether to show series labels.
BarSeriesLabelDefines label settings for bar series.
SeriesLabelBase.BackColorGets or sets the label’s background color.
SeriesLabelBase.BorderGets the label’s border settings.
SeriesLabelBase.FontGets or sets the font used to display the label’s content.
BarSeriesLabel.PositionSpecifies the position of series point labels, relative to their corresponding Bars.
SeriesLabelBase.TextOrientationSpecifies the direction of text within the series labels.
SeriesLabelBase.TextPatternGets or sets a string which represents the pattern specifying the text to be displayed within series labels.
csharp
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}";            
}
vb
Private Sub OnFormLoad(ByVal sender As Object, ByVal e As EventArgs)
    chartControl1.Series(0).LabelsVisibility = DevExpress.Utils.DefaultBoolean.[True]

    Dim seriesLabel As BarSeriesLabel = TryCast(chartControl1.Series(0).Label, 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}"
End Sub

See Also

Series Labels

SeriesLabelBase Class

SeriesLabelBase Members

DevExpress.XtraCharts Namespace