[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
   Getting Started
  [Expand]Grid View
  [Expand]Tree List
  [Expand]Card View
  [Collapse]Chart Control
   [Expand]Product Information
   [Expand]Getting Started
    [Expand]Creating Charts
    [Collapse]Chart Elements
       Diagram Overview
       Simple Diagram
       Swift Plot Diagram
       Gantt Diagram
       Radar and Polar Diagrams
       Simple Diagram 3D
       XY-Diagram 3D
       Funnel Diagram 3D
     [Expand]Chart Titles
    [Expand]End-User Interaction
     Supported Browsers
     Adding a Web Chart
     Handling Client-side Scripts
     Medium Trust Support
     Web Farm and Web Gardens Support
   [Expand]Design-Time Features
   [Expand]Visual Elements
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Site Navigation and Layout
  [Expand]HTML Editor
  [Expand]Vertical Grid
  [Expand]Data Editors
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Controls
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

XY-Diagram 3D

This document details specifics of the XY-Diagram 3D type. It lists series view types associated with this diagram type, demonstrates how to access its specific options (both at design time and runtime), and describes these options. Before reading this text, you may wish to review the basics of using diagram in the ASP.NET Chart Control.

This document consists of the following sections.

Expanded Associated Series View Types

In addition to a wide range of series types, the WebChartControl has the capability to plot the most part of these series in an attractive and high resolution pseudo-3D style. Also, Chart Control enables you to adjust the 3D position of your chart using the mouse pointer both at design time and runtime. A typical XY-Diagram 3D example is shown in the following image.

With the XY-Diagram 3D type, you can use series of the following view types.

A completely different graphical engine is used for 3D diagram types to meet their specific requirements. For this reason, a part of the available functionality is unique (as compared to their 2D equivalents) and is supported for these diagram types only. It's impossible to plot 2D and 3D series within the same diagram.

For extended descriptions of the options available for this diagram type, refer to the following section of this document: Specific Options.

The next section of this document explains how to access an object of the XY-Diagram 3D type.

Expanded Accessing a Diagram

To access XY-Diagram 3D options at design time, click your chart to select it. Then, in the Properties window, expand the WebChartControl.Diagram property.

Cast your instance of the Diagram object to the XYDiagram3D type at runtime.

Expanded Specific Options

The XYDiagram3D.AxisX and XYDiagram3D.AxisY properties produce a similar functionality like their equivalents of the XY-Diagram 2D type. For more information, refer to Axes.

The XYDiagram3D.BackColor, XYDiagram3D.BackImage and XYDiagram3D.FillStyle properties determine a diagram's background. Note that multiple panes are supported only for the XY-Diagram 2D type. So, to define the 3D diagram background, accessing its panes is not required.

The XYDiagram3D.PlaneDepthFixed property determines the depth (thickness) of coordinate planes, in diagram pixels.


The diagram pixels is a measurement unit introduced specifically for 3D diagrams to meet their unique requirements.

The XYDiagram3D.SeriesDistance and XYDiagram3D.SeriesDistanceFixed properties specify the distance between two series that the 3D diagram plots. The SeriesDistanceFixed property specifies the distance in pixels while SeriesDistance specifies it in X-axis measurement units.

In addition, you can define the distance between ultimate series and the argument coordinate planes (front and back) in diagram pixels, by using the XYDiagram3D.SeriesIndentFixed property.

Also, note that the Crosshair Cursor and Tooltips features are not available for the XY-Diagram 3D.

Finally, the following category provides properties common to all 3D diagram types. For more detailed information, refer to these properties' descriptions.


In a perspective projection, the lines that are parallel to the object converge as they move towards a theoretical horizon line on the projection surface. The rate at which parallel lines converge is called the perspective angle. This angle is determined by the distance of an imaginary viewer from a 3D diagram object. To enable or disable the 3D perspective, use the Diagram3D.PerspectiveEnabled property. When it is set to true, you can use the Diagram3D.PerspectiveAngle property to define the required angle. Setting the Diagram3D.PerspectiveAngle property to 0 will disable the perspective.


For web charts, there is a restriction, disallowing use of 3D charts under the Medium Trust permission level. To learn more on this, refer to Medium Trust Support.

Expanded See Also

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