ConstantLineTitle.Alignment Property
Gets or sets the alignment of a constant line‘s title.
Namespace: DevExpress.XtraCharts
Assembly: DevExpress.XtraCharts.v20.1.dll
NuGet Packages: DevExpress.Charts, DevExpress.WindowsDesktop.Charts
Declaration
[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public ConstantLineTitleAlignment Alignment { get; set; }
Property Value
Type | Description |
---|---|
ConstantLineTitleAlignment | A ConstantLineTitleAlignment enumeration value which specifies the alignment of a constant line’s title. |
Available values:
Name | Description |
---|---|
Near | Specifies that a constant line title is aligned near to the axis which it belongs to. |
Far | Specifies that a constant line title is aligned far from the axis which it belongs to. |
Remarks
Use the Alignment property to specify the alignment of a constant line‘s title relative to the corresponding Axes.
Near | Far |
---|---|
For more information, refer to Constant Lines.
Example
This example demonstrates how a constant line can be created and customized at runtime.
Since constant lines belong to a diagram’s axis, it’s first required to cast your diagram object to the appropriate diagram’s type. After that, it’s possible to access axes and manage their constant lines collection.
// Cast the chart's diagram to the XYDiagram type, to access its axes.
XYDiagram diagram = (XYDiagram)chartControl1.Diagram;
// Create a constant line.
ConstantLine constantLine1 = new ConstantLine("Constant Line 1");
diagram.AxisY.ConstantLines.Add(constantLine1);
// Define its axis value.
constantLine1.AxisValue = 7;
// Customize the behavior of the constant line.
constantLine1.Visible = true;
constantLine1.ShowInLegend = true;
constantLine1.LegendText = "Some Threshold";
constantLine1.ShowBehind = false;
// Customize the constant line's title.
constantLine1.Title.Visible = true;
constantLine1.Title.Text = "Constant Line Title";
constantLine1.Title.TextColor = Color.Red;
constantLine1.Title.Antialiasing = false;
constantLine1.Title.Font = new Font("Tahoma", 14, FontStyle.Bold);
constantLine1.Title.ShowBelowLine = true;
constantLine1.Title.Alignment = ConstantLineTitleAlignment.Far;
// Customize the appearance of the constant line.
constantLine1.Color = Color.Red;
constantLine1.LineStyle.DashStyle = DashStyle.Dash;
constantLine1.LineStyle.Thickness = 2;