Skip to main content

BootstrapChartCommonAxisSettings.CustomPosition Property

Specifies the position of one axis in relation to the value of another axis.

Namespace: DevExpress.Web.Bootstrap

Assembly: DevExpress.Web.Bootstrap.v24.1.dll

NuGet Package: DevExpress.Web.Bootstrap

Declaration

[DefaultValue(null)]
public virtual object CustomPosition { get; set; }

Property Value

Type Default Description
Object null

The other axis’ value that corresponds to the axes cross point.

Property Paths

You can access this nested property as listed below:

Object Type Path to CustomPosition
BootstrapPolarChart
.SettingsCommonAxis .CustomPosition

Remarks

Chart axes cross at the argument axis and value axis minimum values.

To change the axes cross point coordinates, use any of the following properties:

  • The axis’ Offset property to shift an axis along another axis to the specified number of pixels.
  • The axis’ CustomPosition property to specify new cross point coordinates based on axis values.

When you specify an axis’ CustomPosition property, the corresponding axis (argument/value) is shifted to the specified value of other axis (value/argument). If the property value is outside the other axis’ range, the shifted axis sticks to the pane border.

The data type of the CustomPosition* property value and the other axis should match. For example, if the value axis displays numbers, the argument axis’ CustomPosition property value should also be a number.

Note

If the Chart control displays multiple value axes, use the argument axis’ CustomPositionAxis property to specify the value axis along which the argument axis should be shifted.

The code below shifts the Chart’s axes cross point to (0,0).

<dx:BootstrapChart ID="AxisPositionsChart" runat="server" TitleSettings-Text="Custom Axis Position">
    <SettingsCommonSeries Type="Scatter" />
    <SeriesCollection>
      ...
    </SeriesCollection>
    <ArgumentAxis CustomPosition="0" />
    <ValueAxisCollection>
        <dx:BootstrapChartValueAxis CustomPosition="0" />
    </ValueAxisCollection>
</dx:BootstrapChart>

Bootstrap-Chart-Axis-Custom-Position

Note

Online Demo: Chart - Axis Positions

See Also