Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

NumericAxisY.Range Property

Provides access to the axis range settings. This is a bindable property.

Namespace: DevExpress.Maui.Charts

Assembly: DevExpress.Maui.Charts.dll

NuGet Package: DevExpress.Maui.Charts

#Declaration

C#
public NumericRange Range { get; set; }

#Property Value

Type Description
NumericRange

An object that stores the axis’s whole and visual range settings.

#Remarks

Use the Range property to configure the y-axis’s whole range and visual range.

#Whole Range and Side Margins

The whole range defines the overall axis range the chart can display. An end user can scroll a chart through this range when scrolling is enabled for the axis (ChartView.AxisYNavigationMode). The axis’s whole range is automatically calculated based on the data of all series associated with the axis. To define this range explicitly, use the Min and Max properties.

A chart view adds automatically calculated indents on both sides of the axis by default. To change an indent value, use the SideMargin property.

NumericRange Whole Range

<dxc:ChartView>
  <dxc:ChartView.AxisY>
      <dxc:NumericAxisY>
          <dxc:NumericAxisY.Range>
              <dxc:NumericRange Min="-1" Max="4" SideMargin="1"/>
          </dxc:NumericAxisY.Range>
      </dxc:NumericAxisY>
  </dxc:ChartView.AxisY>
</dxc:ChartView>

#Visual Range

The visual range determines the axis range currently displayed on a screen. If the maximum or minimum value of the series extends beyond the visual range, the chart’s series partially (or completely) falls out of the diagram. A visual range is equal to a whole range extended with the SideMargin indents by default. To change the visual range, use the VisualMin and VisualMax properties. Note that the visual range can be less than or equal to the whole range.

You can allow end users to change a visual range by scrolling and zooming a chart. To do this, set the chart view’s AxisYNavigationMode property to Scrolling or ScrollingAndZooming.

NumericRange Visual Range

<dxc:ChartView AxisYNavigationMode="Scrolling">
  <dxc:ChartView.AxisY>
      <dxc:NumericAxisY>
          <dxc:NumericAxisY.Range>
              <dxc:NumericRange VisualMin="-0.5" VisualMax="3"/>
          </dxc:NumericAxisY.Range>
      </dxc:NumericAxisY>
  </dxc:ChartView.AxisY>
</dxc:ChartView>
See Also