Constant Lines
- 2 minutes 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.
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.
The Constant Line Collection Editor will appear.
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” |
---|---|
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 |
---|---|
Then, it is possible to display a constant line’s titles both in a diagram and in a legend.
- To display a constant line’s description in a chart’s legend, enable the ConstantLine.ShowInLegend property and define the ConstantLine.LegendText property.
- To display a title adjacent to a constant line, enable its TitleBase.Visible property, and define the Title.Text property of the title. In addition, you can adjust the positioning of the title via the ConstantLineTitle.Alignment and ConstantLineTitle.ShowBelowLine properties. The appearance of the title is defined by its TitleBase.TextColor, TitleBase.Antialiasing and TitleBase.Font properties.
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.