ActiveReports 13
3D Pie/Doughnut Charts
ActiveReports 13 > ActiveReports User Guide > Concepts > Section Report Concepts > Section Report Toolbox > Chart > Chart Types (Section Reports) > Pie and Doughnut Charts > 3D Pie/Doughnut Charts

Given below is the list of 3D charts that fall under the Pie/Doughnut Chart category.

Caution: To view a chart in 3D, open the ChartArea Collection Editor in the ChartAreas property and set the ProjectionType property to Orthogonal.

Doughnut Chart

A 3D doughnut chart shows how the percentage of each data item contributes to a total percentage, allowing the data to be viewed in a 3D format.

Chart Information

ChartType Pie/Doughnut 3D
Number of Y values per data point 1
Number of Series 1 or more
Marker Support Series or Data Point
Custom Properties The Clockwise property gets or sets a value indicating whether to display the data in clockwise order.
The ExplodeFactor property gets or sets the amount of separation between data point values. The value must be less than or equal to 1. To explode one section of the doughnut chart, set ExplodeFactor to the data point instead of the series.
The HoleSize property gets or sets the inner radius of the chart. If set to 0, the chart looks like a pie chart. The value must be less than or equal to 1.
The OutsideLabels property gets or sets a value indicating whether the data point labels appear outside the chart.
The Radius property gets or sets the size of the doughnut within the chart area.
The StartAngle property gets or sets the horizontal start angle for the series data points.

Below is an example of how to set the custom chart properties at run time for a 3D doughnut chart as shown in the image above.

To write the code in Visual Basic.NET

Visual Basic
Copy Code
Me.ChartControl1.Series(0).Properties("ExplodeFactor") = 0.0F
Me.ChartControl1.Series(0).Properties("HoleSize") = 0.33F
Me.ChartControl1.Series(0).Properties("OutsideLabels") = False
Me.ChartControl1.Series(0).Properties("Radius") = 2.0F
Me.ChartControl1.Series(0).Properties("StartAngle") = 50.0F                      

To write the code in C#

C#
Copy Code
this.chartControl1.Series[0].Properties["ExplodeFactor"] = 0f;
this.chartControl1.Series[0].Properties["HoleSize"] = .33f;
this.chartControl1.Series[0].Properties["OutsideLabels"] = false;
this.chartControl1.Series[0].Properties["StartAngle"] = 50f;

Funnel Chart

A 3D funnel chart shows how the percentage of each data item contributes to the whole, allowing the data to be viewed in a 3D format.

Chart Information
ChartType Pie/Doughnut 3D
Number of Y values per data points 1
Number of Series 1 or more
Marker Support Series or Data Point

Custom Properties

The BaseStyle property gets or sets a circular or square base drawing style for the 3D funnel chart.
The CalloutLine property gets or sets the style for a line connecting the marker label to its corresponding funnel section. The default value is a black one-point line.
The FunnelStyle property gets or sets the Y value for the series points to the width or height of the funnel. The default value is YIsHeight.
The MinPointHeight property gets or sets the minimum height allowed for a data point in the funnel chart. The height is measured in relative coordinates.
The NeckHeight property gets or sets the neck height for the funnel chart. This property can only be used with the FunnelStyle property set to YIsHeight. The default value is 5.
The NeckWidth property gets or sets the neck width for the funnel chart. This property can only be used with the FunnelStyle property set to YIsHeight. The default value is 5.
The OutsideLabels property gets or sets a value indicating whether the labels are placed outside of the funnel chart. The default value is True.
The OutsideLabelsPlacement property gets or sets a value indicating whether the data point labels appear on the left or right side of the funnel. This property can only be used with the OutsideLabels property set to True.
The PointGapPct property gets or sets the amount of space between the data points of the funnel chart. The PointGapPct is measured in relative coordinates. The default value is 0, and valid values range from 0 to 100.
The RotationAngle property gets or sets the left-to-right rotation angle of the funnel. The valid values range from -180 to 180 degrees. This property is only effective with the Projection property set to Orthogonal and the BaseStyle property set to SquareBase.

Below is an example of how to set the custom chart properties at run time for a 3D funnel chart.

To write the code in Visual Basic.NET

Visual Basic
Copy Code
Imports GrapeCity.ActiveReports.Chart
Imports GrapeCity.ActiveReports.Chart.Graphics                       
Visual Basic
Copy Code
With Me.ChartControl1.Series(0)
    .Properties("BaseStyle") = BaseStyle.SquareBase
    .Properties("CalloutLine") = New Line(Color.Black, 2, LineStyle.Dot)
    .Properties("FunnelStyle") = FunnelStyle.YIsWidth
    .Properties("MinPointHeight") = 10.0F
    .Properties("NeckWidth") = 20.0F
    .Properties("NeckHeight") = 5.0F
    .Properties("OutsideLabels") = True
    .Properties("OutsideLabelsPlacement") = LabelsPlacement.Right
    .Properties("PointGapPct") = 3.0F
    .Properties("RotationAngle") = 3.0F
End With

 

To write the code in C#

C#
Copy Code
using GrapeCity.ActiveReports.Chart;
using GrapeCity.ActiveReports.Chart.Graphics;                        
C#
Copy Code
this.ChartControl1.Series[0].Properties["BaseStyle"] = BaseStyle.SquareBase;
this.ChartControl1.Series[0].Properties["CalloutLine"] = new Line(Color.Black, 2, LineStyle.Dot);
this.ChartControl1.Series[0].Properties["FunnelStyle"] = FunnelStyle.YIsWidth;
this.ChartControl1.Series[0].Properties["MinPointHeight"] = 10f;
this.ChartControl1.Series[0].Properties["NeckWidth"] = 20f;
this.ChartControl1.Series[0].Properties["NeckHeight"] = 5f;
this.ChartControl1.Series[0].Properties["OutsideLabels"] = true;
this.ChartControl1.Series[0].Properties["OutsideLabelsPlacement"] = LabelsPlacement.Right;
this.ChartControl1.Series[0].Properties["PointGapPct"] = 3f;
this.ChartControl1.Series[0].Properties["RotationAngle"] = 3f;                                

Pyramid Chart

A 3D Pyramid chart shows how the percentage of each data item contributes to the whole, allowing the data to be viewed in a 3D format.

Chart Information
ChartType Pie/Doughnut 3D
Number of Y values per data point 1
Number of Series 1 or more
Marker Support Series or Data Points
Custom Properties

The BaseStyle property gets or sets a circular or square base drawing style for the 3D pyramid chart.
The CalloutLine property gets or sets the style for a line connecting the marker label to its corresponding pyramid section. The default value is a black one-point line.
The MinPointHeight property gets or sets the minimum height allowed for a data point in the pyramid chart. The height is measured in relative coordinates.
The OutsideLabels property gets or sets a value indicating whether the labels are placed outside of the pyramid chart. The default value is True.
The OutsideLabelsPlacement property gets or sets a value indicating whether the data point labels appear on the left or right side of the pyramid. This property can only be used with the OutsideLabels property set to True.
The PointGapPct property gets or sets the amount of space between the data points of the pyramid chart. The PointGapPct is measured in relative coordinates. The default value is 0, and valid values range from 0 to 100.
The RotationAngle property gets or sets the left-to-right rotation angle of the pyramid. The valid values range from -180 to 180 degrees. This property is only effective with the Projection property set to Orthogonal and the BaseStyle property set to SquareBase.

Below is an example of how to set the custom chart properties at run time for a Pyramid chart.

To write the code in Visual Basic.NET

Visual Basic
Copy Code
Imports GrapeCity.ActiveReports.Chart
Imports GrapeCity.ActiveReports.Chart.Graphics                       
Visual Basic
Copy Code
With Me.ChartControl1.Series(0)
.Properties("BaseStyle") = BaseStyle.SquareBase .Properties("MinPointHeight") = 10.0F .Properties("OutsideLabels") = True .Properties("OutsideLabelsPlacement") = LabelsPlacement.Right .Properties("PointGapPct") = 3.0F
.Properties("RotationAngle") = 3.0F End With

To write the code in C#

C#
Copy Code
using GrapeCity.ActiveReports.Chart;
using GrapeCity.ActiveReports.Chart.Graphics;                        
C#
Copy Code
this.ChartControl1.Series[0].Properties["BaseStyle"] = BaseStyle.SquareBase;
this.ChartControl1.Series[0].Properties["MinPointHeight"] = 10f;
this.ChartControl1.Series[0].Properties["OutsideLabels"] = true;
this.ChartControl1.Series[0].Properties["OutsideLabelsPlacement"] = LabelsPlacement.Right;
this.ChartControl1.Series[0].Properties["PointGapPct"] = 3f;
this.ChartControl1.Series[0].Properties["RotationAngle"] = 3f; 

Pie Chart

This type of chart displays the contribution of each value to a total.

Chart Information

ChartType Pie/Doughnut 3D
Number of Y values per data point 1
Number of Series 1 or more
Marker Support Series or Data Point
Custom Properties

Ring Chart

This chart type uses rings (inner and outer) to represent data.

Chart Information

ChartType Pie/Doughnut 3D
Number of Y values per data point 1
Number of Series 1 or more
Marker Support Series or Data Point
Custom Properties
See Also