Pie3DSeriesView Class

Represents a series view of the 3D Pie type.

Assembly: DevExpress.XtraCharts.v18.1.dll

Declaration

C#
VB.NET

[TypeConverter(typeof(Pie3DSeriesViewTypeConverter))]
public class Pie3DSeriesView :
    PieSeriesViewBase,
    ISimpleDiagram3DSeriesView

<TypeConverter(GetType(Pie3DSeriesViewTypeConverter))>
Public Class Pie3DSeriesView
    Inherits PieSeriesViewBase
    Implements ISimpleDiagram3DSeriesView

Remarks

The Pie3DSeriesView class provides the functionality of a series view of the 3D pie type within a chart control.

The Pie3DSeriesView class inherits properties and methods from the base PieSeriesView class which defines the common settings of pie series views.

Note that a particular view type can be defined for a series via its SeriesBase.View property.

For more information on series views of the 3D pie type please see the Pie Chart topic.

Example

The following example demonstrates how to create a ChartControl with a series of the Pie3DSeriesView type, set its general properties, and add this chart to a form at runtime. Before proceeding with this example, first create a Windows Forms Application in Visual Studio, and include all necessary assemblies to the References list of your project.

Then, add the following code to the Form.Load event handler.

C#
VB.NET

using System;
using System.Windows.Forms;
using DevExpress.XtraCharts;
// ...

private void Form1_Load(object sender, EventArgs e) {
    // Create an empty chart.
    ChartControl PieChart3D = new ChartControl();

    // Create a pie series.
    Series series1 = new Series("Pie Series 1", ViewType.Pie3D);

    // Populate the series with points.
    series1.Points.Add(new SeriesPoint("Russia", 17.0752));
    series1.Points.Add(new SeriesPoint("Canada", 9.98467));
    series1.Points.Add(new SeriesPoint("USA", 9.63142));
    series1.Points.Add(new SeriesPoint("China", 9.59696));
    series1.Points.Add(new SeriesPoint("Brazil", 8.511965));
    series1.Points.Add(new SeriesPoint("Australia", 7.68685));
    series1.Points.Add(new SeriesPoint("India", 3.28759));
    series1.Points.Add(new SeriesPoint("Others", 81.2));

    // Add the series to the chart.
    PieChart3D.Series.Add(series1);

    // Adjust the value numeric options of the series.
    series1.PointOptions.ValueNumericOptions.Format = NumericFormat.Percent;
    series1.PointOptions.ValueNumericOptions.Precision = 0;

    // Adjust the view-type-specific options of the series.
    ((Pie3DSeriesView)series1.View).Depth = 30;
    ((Pie3DSeriesView)series1.View).ExplodedPoints.Add(series1.Points[0]);
    ((Pie3DSeriesView)series1.View).ExplodedDistancePercentage = 30;

    // Access the diagram's options.
    ((SimpleDiagram3D)PieChart3D.Diagram).RotationType = RotationType.UseAngles;
    ((SimpleDiagram3D)PieChart3D.Diagram).RotationAngleX = -35;

    // Add a title to the chart and hide the legend.
    ChartTitle chartTitle1 = new ChartTitle();
    chartTitle1.Text = "3D Pie Chart";
    PieChart3D.Titles.Add(chartTitle1);
    PieChart3D.Legend.Visible = false;

    // Add the chart to the form.
    PieChart3D.Dock = DockStyle.Fill;
    this.Controls.Add(PieChart3D);
}

Imports System
Imports System.Windows.Forms
Imports DevExpress.XtraCharts
' ...

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
    ' Create an empty chart.
    Dim PieChart3D As New ChartControl()

    ' Create a pie series.
    Dim series1 As New Series("Pie Series 1", ViewType.Pie3D)

    ' Populate the series with points.
    series1.Points.Add(New SeriesPoint("Russia", 17.0752))
    series1.Points.Add(New SeriesPoint("Canada", 9.98467))
    series1.Points.Add(New SeriesPoint("USA", 9.63142))
    series1.Points.Add(New SeriesPoint("China", 9.59696))
    series1.Points.Add(New SeriesPoint("Brazil", 8.511965))
    series1.Points.Add(New SeriesPoint("Australia", 7.68685))
    series1.Points.Add(New SeriesPoint("India", 3.28759))
    series1.Points.Add(New SeriesPoint("Others", 81.2))

    ' Add the series to the chart.
    PieChart3D.Series.Add(series1)

    ' Adjust the value numeric options of the series.
    series1.PointOptions.ValueNumericOptions.Format = NumericFormat.Percent
    series1.PointOptions.ValueNumericOptions.Precision = 0

    ' Adjust the view-type-specific options of the series.
    CType(series1.View, Pie3DSeriesView).Depth = 30
    CType(series1.View, Pie3DSeriesView).ExplodedPoints.Add(series1.Points(0))
    CType(series1.View, Pie3DSeriesView).ExplodedDistancePercentage = 30

    ' Access the diagram's options.
    CType(PieChart3D.Diagram, SimpleDiagram3D).RotationType = RotationType.UseAngles
    CType(PieChart3D.Diagram, SimpleDiagram3D).RotationAngleX = -35

    ' Add a title to the chart and hide the legend.
    Dim chartTitle1 As New ChartTitle()
    chartTitle1.Text = "3D Pie Chart"
    PieChart3D.Titles.Add(chartTitle1)
    PieChart3D.Legend.Visible = False

    ' Add the chart to the form.
    PieChart3D.Dock = DockStyle.Fill
    Me.Controls.Add(PieChart3D)
End Sub

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the Pie3DSeriesView class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#
VB.NET

how-to-create-a-3d-pie-chart-e1028/CS/3DPieChart/Form1.cs#L36

// Adjust the view-type-specific options of the series.
((Pie3DSeriesView)series1.View).Depth = 30;
((Pie3DSeriesView)series1.View).ExplodedPoints.Add(series1.Points[0]);

how-to-create-a-3d-pie-chart-e1028/VB/3DPieChart/Form1.vb#L38

' Adjust the view-type-specific options of the series.
CType(series1.View, Pie3DSeriesView).Depth = 30
CType(series1.View, Pie3DSeriesView).ExplodedPoints.Add(series1.Points(0))