ConstantLine.ShowInLegend Property

Gets or sets a value that specifies whether the constant line is represented in the chart control’s legend.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v20.2.dll

NuGet Packages: DevExpress.Charts, DevExpress.WindowsDesktop.Charts

Declaration

C#

[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public bool ShowInLegend { get; set; }

VB.NET

<XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)>
Public Property ShowInLegend As Boolean

Property Value

Type	Description
Boolean	true to represent the constant line in the legend; otherwise, false.

Remarks

Use the ShowInLegend property to control whether the constant line is indicated within the chart control’s legend.

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.

C#

// 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;

VB.NET

' Cast the chart's diagram to the XYDiagram type, to access its axes.
Dim diagram As XYDiagram = CType(chartControl1.Diagram, XYDiagram)

' Create a constant line.
Dim constantLine1 As 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

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ShowInLegend property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-implement-range-selection-via-a-separate-chartcontrol-e3113/CS/InteractiveRangeSelect/Form1.cs#L29

lineStart.LineStyle.Thickness = 4;
lineStart.ShowInLegend = false;

winforms-dashboard-custom-properties/CS/WinForms-Dashboard-Custom-Properties/Modules/ConstantLineUserValueModule.cs#L95

chartAxis.ConstantLines.Add(line);
line.ShowInLegend = false;
line.Color = Color.Green;

wpf-dashboard-custom-properties/CS/Wpf-Dashboard-Custom-Properties/Modules/ChartItemModule/ChartOptions/ConstantLine.cs#L93

chartAxis.ConstantLines.Add(line);
line.ShowInLegend = false;
line.Color = System.Drawing.Color.Green;

WinForms-Dashboard-How-to-Highlight-Data-in-the-Scatter-Chart-Dashboard-Item/CS/ChartFormatRulesSample/ScatterChartConstantLineUserValueModule.cs#L105

ConstantLine line = new ConstantLine() { AxisValue = value };
line.ShowInLegend = false;
line.Color = color;

VB.NET

how-to-implement-range-selection-via-a-separate-chartcontrol-e3113/VB/InteractiveRangeSelect/Form1.vb#L35

lineStart.LineStyle.Thickness = 4
lineStart.ShowInLegend = False

winforms-dashboard-custom-properties/VB/WinForms-Dashboard-Custom-Properties/Modules/ConstantLineUserValueModule.vb#L101

chartAxis.ConstantLines.Add(line)
line.ShowInLegend = False
line.Color = Color.Green

wpf-dashboard-custom-properties/VB/Wpf-Dashboard-Custom-Properties/Modules/ChartItemModule/ChartOptions/ConstantLine.vb#L117

chartAxis.ConstantLines.Add(line)
line.ShowInLegend = False
line.Color = System.Drawing.Color.Green

WinForms-Dashboard-How-to-Highlight-Data-in-the-Scatter-Chart-Dashboard-Item/VB/ChartFormatRulesSample/ScatterChartConstantLineUserValueModule.vb#L117

Dim line As New ConstantLine() With {.AxisValue = value}
line.ShowInLegend = False
line.Color = color