Constant Lines

  • 2 min to read

This document describes how to display a constant line, and customize its appearance and position across an axis. Before you proceed with this document, you may wish to review the basics of using axes.

A Constant line is used to visually represent an axis value as a line perpendicular to the axis to which it belongs. It can be drawn over or behind the diagram's series.

ConstantLines_0

To create a constant line and add it to an axis at design time, locate the axis in the Properties window, and click the ellipsis button for the Axis2D.ConstantLines property.

ConstantLinesCollection

The Constant Line Collection Editor will appear.

ConstantLineEditor

In this editor, click Add to create a constant line, and define its properties.

The key property of a constant line is the ConstantLine.AxisValue property, which determines the value on the axis across which the constant line is drawn. This value should fall into the range defined for the current axis, in order for the constant line to be visible on a diagram.

Note that this value also should be appropriate for the axis scale type, as the following images demonstrate.

AxisValue = 10 AxisValue = "D"
AxisValue_10 AxisValue_D

To control whether a constant line should be drawn behind or above a chart's series, use the ConstantLine.ShowBehind property. Note that this property does not affect the position of a constant line's title.

ShowBehind = False ShowBehind = True
ShowBehind_false.png ShowBehind_true.png

Then, it is possible to display a constant line's titles both in a diagram and in a legend.

Finally, it is possible to define the appearance options of a constant line, notably the ConstantLine.Color, LineStyle.DashStyle and LineStyle.Thickness properties.

Use the ConstantLine.Visible property to hide a constant line while maintaining it in an axis' collection.

See Also