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.v23.2.dll

NuGet Package: DevExpress.Web.Bootstrap

Declaration

C#

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

VB.NET

<DefaultValue(Nothing)>
Public Overridable Property CustomPosition As Object

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>

Note

Online Demo: Chart - Axis Positions