Axes

  • 3 minutes to read

The Chart3D control axes can be configured. For instance, axis titles and grid lines can be shown or hidden, and the axis range can be defined.

Chart3D-Axes-TitleImage

This document explains how to:

Configure Axis Elements

An axis consists of elements including an axis title, axis labels and grid lines. The following image highlights these axis elements.

Chart3D-Axes-Elements

To configure an axis, create a new instance of the axis and customize its axis element properties The XAML markup below shows how chart elements can be declared.

<dxc:Chart3DControl.YAxis>
    <dxc:YAxis3D GridLinesMinorVisible="True"
                 Interlaced="True">
        <dxc:YAxis3D.Label>
            <dxc:AxisLabel TextPattern="{}{V:F1}"/>
        </dxc:YAxis3D.Label>
        <dxc:YAxis3D.Title>
            <dxc:AxisTitle Content="Sepal Width" />
        </dxc:YAxis3D.Title>
    </dxc:YAxis3D>
</dxc:Chart3DControl.YAxis>

The following classes and properties configure the display of 3D chart axis elements

Class or Property

Description

Chart3DControl.XAxis

Chart3DControl.YAxis

Chart3DControl.ZAxis

Access to the 3D Chart X, Y and Z axes of a 3D chart.

XAxis3D

The X (argument) axis of a 3D Chart.

YAxis3D

The Y (argument) axis of a 3D Chart.

ZAxis3D

The Z (value) axis of a 3D Chart.

Axis.Title

Access to the title configuration of an axis.

AxisTitle

Defines axis title options.

AxisBase.Label

Access to the label configuration of an axis.

AxisLabel

Defines axis label options.

AxisBase.GridLinesVisible

Specifies whether major axis grid lines should be shown.

AxisBase.GridLinesMinorVisible

Specifies whether minor axis grid lines should be shown.

AxisBase.MinorCount

Specifies the number of minor grid lines.

AxisBase.Interlaced

Specifies whether interlacing is applied to the axis.

Configure Axis Scales

The scale type of an argument axis is based on the scale type defined by a series. Argument scale types are defined on each series by the Series3DBase.XArgumentScaleType property for the X axis, and the Series3DBase.YArgumentScaleType property for the Y axis. Each argument axis allows for one of the three scale types.

Scale Type Configuration Properties
Qualitative The AxisBase.QualitativeScaleComparer property specifies the ordering of qualitative values.
Numeric The ArgumentAxis3D.NumericScaleOptions property specifies the numeric scale options.
Date-Time The ArgumentAxis3D.DateTimeScaleOptions property specifies the date-time scale options.

Notably, the scale type of the Z-axis is always Numeric.

The following XAML demonstrates how to configure scale options.

<dxc:Chart3DControl.XAxis>
    <dxc:XAxis3D>
        <dxc:XAxis3D.DateTimeScaleOptions>
            <dxc:AutomaticDateTimeScaleOptions WorkdaysOnly="True"/>
        </dxc:XAxis3D.DateTimeScaleOptions>
    </dxc:XAxis3D>
</dxc:Chart3DControl.XAxis>
<dxc:Chart3DControl.YAxis>
    <dxc:YAxis3D>
        <dxc:YAxis3D.NumericScaleOptions>
            <dxc:ContinuousNumericScaleOptions GridAlignment="2"/>
        </dxc:YAxis3D.NumericScaleOptions>
    </dxc:YAxis3D>
</dxc:Chart3DControl.YAxis>

The above markup includes two unfamiliar classes: AutomaticDateTimeScaleOptions and ContinuousNumericScaleOptions. These are among a set of classes that define the behavior of the corresponding scale types. The following scale behaviors are defined.

Behavior

Classes Implementing It

Description

Manual

ManualDateTimeScaleOptions

ManualNumericScaleOptions

With manual behavior enabled, the axis scale is divided into intervals specified by the MeasureUnit property. Aggregation can be applied to series data.

Automatic

AutomaticDateTimeScaleOptions

AutomaticNumericScaleOptions

With automatic behavior enabled, the axis scale is divided into intervals automatically calculated by the AutomaticMeasureUnitsCalculator property. Aggregation can be applied to series data.

Continuous

ContinuousDateTimeScaleOptions

ContinuousNumericScaleOptions

With continuous behavior enabled, the axis scale is not divided into intervals, so aggregation cannot be applied when this behavior is used.

Specify Axis Range

The range of values that should be shown along an axis is given by its Whole Range. Note that a range cannot be defined over a qualitative scale type.

The following XAML demonstrates how to specify the range.

<dxc:Chart3DControl.ZAxis>
    <dxc:ZAxis3D>
        <dxc:ZAxis3D.WholeRange>
            <dxc:Range MinValue="10"
                       MaxValue="15"
                       dxc:ZAxis3D.AlwaysShowZeroLevel="False"/>
        </dxc:ZAxis3D.WholeRange>
    </dxc:ZAxis3D>
</dxc:Chart3DControl.ZAxis>

The following table contains the classes and properties used by the above markup.

Class or Property Description
Axis.WholeRange Specifies the range of values that should be shown along an axis.
Range Defines the common settings for an axis range.
Range.MinValue Specifies the minimum range value of an axis.
Range.MaxValue Specifies the maximum range value of an axis.
ZAxis3D.AlwaysShowZeroLevel An attached property that specifies whether a zero value should be displayed.