XYDiagram2D.DependentAxesYRange Property

Gets or sets whether the visual range of all Y-axes (axes of values) should be calculated only by values of points contained in the visual range of the X-axis (axis of arguments).

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v21.2.dll

NuGet Package: DevExpress.Charts

Declaration

C#

[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public DefaultBoolean DependentAxesYRange { get; set; }

VB.NET

<XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)>
Public Property DependentAxesYRange As DefaultBoolean

Property Value

Type	Description
DefaultBoolean	The value that defines whether the y-axis visual range should be calculated based on the x-axis visual range.

Available values:

Name	Description
True	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

Remarks

The DependentAxesYRange property can have the following values:

Value	Description
Default	The default behavior of the value visual range.
True	The visual range should be calculated by the values of points contained in the visual range of the axis of arguments.
False	The visual range should be calculated by all values.

The following images demonstrates this property in action.

DependentAxesYRange = false	DependentAxesYRange = true

Note

The DependentAxesYRange and WholeRange.AlwaysShowZeroLevel properties are dependent. AlwaysShowZeroLevel is taken into account when the visual range is calculated.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DependentAxesYRange 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.

VB.NET

winforms-charts-create-real-time-chart/VB/RealTimeChartUpdates/Form1.vb#L37

diagram.AxisX.WholeRange.SideMarginsValue = 0
diagram.DependentAxesYRange = DefaultBoolean.True
diagram.AxisY.WholeRange.AlwaysShowZeroLevel = False

winforms-charts-create-real-time-chart-and-collect-data-in-separate-thread/VB/RealTimeChartUpdates/Form1.vb#L52

diagram.AxisX.VisualRange.EndSideMargin = 200
diagram.DependentAxesYRange = DefaultBoolean.True
diagram.AxisY.WholeRange.AlwaysShowZeroLevel = False