[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Collapse]Charts Suite
   [Expand]Chart Control
   [Collapse]Chart3D Control
    [Expand]Getting Started
    [Expand]Series
     Legends
     Axes
     Titles
     Interactivity
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Axes

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

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.

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

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.

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?​​​​​​​