ConstantLine.LegendText Property

Gets or sets the text that identifies the constant line within the legend of a chart control.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v20.1.dll

Declaration

[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public string LegendText { get; set; }
<XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)>
Public Property LegendText As String

Property Value

Type Description
String

A String value that specifies the constant line's legend text.

Remarks

Use the LegendText property to specify the text that will be displayed within a chart control's legend and will identify the current constant line.

If the LegendText property is not set, a constant line is identified within the legend by its name which is defined via the constant line's ChartElementNamed.Name property.

For more information, refer to Constant Lines.

Examples

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;
See Also