Skip to main content

Pie3DSeriesView.Depth Property

Gets or sets the thickness of the entire pie in 3D Pie Chart.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.1.dll

NuGet Package: DevExpress.Charts

Declaration

[XtraChartsLocalizableCategory(XtraChartsCategory.Appearance)]
[XtraSerializableProperty]
public int Depth { get; set; }

Property Value

Type Description
Int32

An integer value. It should be more than 0 and less or equal 100.

Remarks

This property is measured as a percentage relative to a pie diameter. In the picture below it is equal to 50.

Pie_depth.png

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.

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);
}

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

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.

See Also