Log In
[Expand]Welcome to DevExpress .NET Documentation
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Collapse]Charts Suite
   [Expand]Chart Control
   [Collapse]Chart3D Control
    [Expand]Getting Started
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Diagram Control
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Report Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation


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.

This document explains how to:

Expanded Configure Axis Elements

An axis consists of elements including an axis title, axis labels and grid lines. The following image highlights these axis 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.

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

Class or Property Description
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.

Expanded 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.

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
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
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
With continuous behavior enabled, the axis scale is not divided into intervals, so aggregation cannot be applied when this behavior is used.

Expanded 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.

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 or not a zero value should be displayed.

Is this topic helpful?​​​​​​​