ActiveReports 6 Online Help Send comments on this topic.
3D Charts
See Also
ActiveReports 6 > ActiveReports User Guide > Concepts > Charts > Chart Types > 3D Charts

Glossary Item Box

The ActiveReports Chart control can draw a number of 3D chart types:

See below for details on each of the 3D chart types.

Note: To see a chart in three dimensions, set the ProjectionType to Orthogonal. The ProjectionType is found in the ChartArea Collection dialog in the Projection section.

Area 3D Chart

Use a 3D area chart to compare trends in two or more data series over a period of time or in specific categories, so that data can be viewed side by side.


Click to EnlargeClick to Enlarge

ShowChart Information

Chart Information
Number of Y values per data point 1
Number of Series 1 or more
Marker Support Series or Data Point
Custom Properties LineBackdrop gets or sets the backdrop information for the 3D line.
Thickness gets or sets the thickness of the 3D line.
Width gets or sets the width of the 3D line.

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

ShowTo write the code in Visual Basic.NET

Visual Basic.NET code. Paste ABOVE the report class. Copy Code
Imports DataDynamics.ActiveReports.Chart.Graphics
Visual Basic.NET code. Paste INSIDE the section Format event. Copy Code
Me.ChartControl1.Series(0).Properties("LineBackdrop") = New Chart.Graphics.Backdrop(Color.Red, CType(150, Byte))
Me.ChartControl1.Series(0).Properties("Thickness") = 5.0F
Me.ChartControl1.Series(0).Properties("Width") = 30.0F

ShowTo write the code in C#

C# code. Paste ABOVE the report class. Copy Code
using DataDynamics.ActiveReports.Chart.Graphics
C# code. Paste INSIDE the section Format event. Copy Code
this.chartControl1.Series[0].Properties["LineBackdrop"] = new Chart.Graphics.Backdrop(Color.Red, ((System.Byte)(150)));
this.chartControl1.Series[0].Properties["Thickness"] = 5f;
this.chartControl1.Series[0].Properties["Width"] = 30f;

Bar 3D Chart

Use a 3D bar chart to compare values of items across categories, allowing the data to be viewed conveniently in a 3D format.


Click to EnlargeClick to Enlarge

ShowChart Information

Chart Information
Number of Y values per data point 1
Number of Series 1 or more
Marker Support Series or Data Point
Custom Properties BarTopPercent gets or sets the percentage of the top of the bar that is shown for Cone or Custom BarTypes.
BarType gets or sets the type of bars that is displayed.
Gap gets or sets the space between the bars of each X axis value.
RotationAngle gets or sets the starting horizontal angle for custom 3D bar shapes. Can only be used with the Custom BarType.
VertexNumber gets or sets the number of vertices for the data point, used to create custom 3D bar shapes. Can only be used with the Custom BarType. Bars must contain 3 or more vertices.

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

ShowTo write the code in Visual Basic.NET

Visual Basic.NET code. Paste INSIDE the section Format event. Copy Code
Me.ChartControl1.Series(0).Properties("BarTopPercent") = 80.0F
Me.ChartControl1.Series(0).Properties("BarType") = BarType.Custom
Me.ChartControl1.Series(0).Properties("Gap") = 65.0F
Me.ChartControl1.Series(0).Properties("RotationAngle") = 0.0F
Me.ChartControl1.Series(0).Properties("VertexNumber") = 6

ShowTo write the code in C#

C# code. Paste INSIDE the section Format event. Copy Code
this.chartControl1.Series[0].Properties["BarTopPercent"] = 80f;
this.chartControl1.Series[0].Properties["BarType"] = BarType.Custom;
this.chartControl1.Series[0].Properties["Gap"] = 65f;
this.chartControl1.Series[0].Properties["RotationAngle"] = 0f;
this.chartControl1.Series[0].Properties["VertexNumber"] = 6;

3D Clustered Bar Chart

Use a 3D clustered bar chart to compare values of items across categories, allowing the data to be viewed conveniently in a 3D format.


Click to EnlargeClick to Enlarge

ShowChart Information

Chart Information
Number of Y values per data point 1
Number of Series 1 or more
Marker Support Series or Data Point
Custom Properties BarTopPercent gets or sets the percentage of the top of the bar that is shown for Cone or Custom BarTypes.
BarType gets or sets the type of bars that are displayed.
Gap gets or sets the space between the bars of each X axis value.
RotationAngle gets or sets the starting horizontal angle for custom 3D bar shapes. Can only be used with the Custom BarType.
VertexNumber gets or sets the number of vertices for the data point, used to create custom 3D bar shapes. Can only be used with the Custom BarType. Bars must contain 3 or more vertices.

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

ShowTo write the code in Visual Basic.NET

Visual Basic.NET code. Paste ABOVE the report class. Copy Code
Imports DataDynamics.ActiveReports.Chart
Visual Basic.NET code. Paste INSIDE the section Format event. Copy Code
' set the custom properties for series 1
Me.ChartControl1.Series(0).Properties("BarTopPercent") = 50.0F
Me.ChartControl1.Series(0).Properties("BarType") = BarType.Custom
Me.ChartControl1.Series(0).Properties("Gap") = 300.0F
Me.ChartControl1.Series(0).Properties("RotationAngle") = 0.0F
Me.ChartControl1.Series(0).Properties("VertexNumber") = 6

' set the custom properties for series 2
Me.ChartControl1.Series(1).Properties("BarTopPercent") = 20.0F
Me.ChartControl1.Series(1).Properties("BarType") = BarType.Custom
Me.ChartControl1.Series(1).Properties("Gap") = 300.0F
Me.ChartControl1.Series(1).Properties("RotationAngle") = 90.0F
Me.ChartControl1.Series(1).Properties("VertexNumber") = 3

ShowTo write the code in C#

C# code. Paste ABOVE the report class. Copy Code
using DataDynamics.ActiveReports.Chart;
C# code. Paste INSIDE the section Format event. Copy Code
// set the custom properties for series 1
this.chartControl1.Series[0].Properties["BarTopPercent"] = 50f;
this.chartControl1.Series[0].Properties["BarType"] = BarType.Custom;
this.chartControl1.Series[0].Properties["Gap"] = 300f;
this.chartControl1.Series[0].Properties["RotationAngle"] = 0f;
this.chartControl1.Series[0].Properties["VertexNumber"] = 6;

// set the custom properties for series 2
this.chartControl1.Series[1].Properties["BarTopPercent"] = 20f;
this.chartControl1.Series[1].Properties["BarType"] = BarType.Custom;
this.chartControl1.Series[1].Properties["Gap"] = 300f;
this.chartControl1.Series[1].Properties["RotationAngle"] = 90f;
this.chartControl1.Series[1].Properties["VertexNumber"] = 3;

Doughnut 3D 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.


Click to EnlargeClick to Enlarge

ShowChart Information

Chart Information
Number of Y values per data point 1
Number of Series 1
Marker Support Series or Data Point
Custom Properties ExplodeFactor 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 on the data point instead of on the series.
HoleSize 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.
OutsideLabels gets or sets a value indicating whether the data point labels appear outside of the graph.
StartAngle 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.

ShowTo write the code in Visual Basic.NET

Visual Basic.NET code. Paste INSIDE the section Format event. 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("StartAngle") = 50.0F

ShowTo write the code in C#

C# code. Paste INSIDE the section Format event. 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 3D 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 three dimensional format.


Click to EnlargeClick to Enlarge

ShowChart Information

Chart Information
Number of Y values per data points 1
Number of Series 1
Marker Support Series or Data Point
Custom Properties BaseStyle Gets or sets a circular or square base drawing style for the 3D funnel chart.
CalloutLine 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.
FunnelStyle Gets or sets the Y value for the series points to the width or height of the funnel. The default value is YIsHeight.
MinPointHeight Gets or sets the minimum height allowed for a data point in the funnel chart. The height is measured in relative coordinates.
NeckHeight 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.
NeckWidth 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.
OutsideLabels Gets or sets a value indicating whether the labels are placed outside of the funnel chart. The default value is True.
OutsideLabelsPlacement 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.
PointGapPct 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.
RotationAngle 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.

ShowTo write the code in Visual Basic.NET

Visual Basic.NET code. Paste ABOVE the report class. Copy Code
Imports DataDynamics.ActiveReports.Chart
Imports DataDynamics.ActiveReports.Chart.Graphics
Visual Basic.NET code. Paste INSIDE the section Format event. 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

ShowTo write the code in Visual Basic.NET

C# code. Paste ABOVE the report class. Copy Code
using DataDynamics.ActiveReports.Chart;
using DataDynamics.ActiveReports.Chart.Graphics;
C# code. Paste INSIDE the section Format event. 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;

Horizontal Bar 3D Chart

Use a horizontal 3D bar chart to compare values of items across categories, allowing the data to be viewed conveniently in a 3D format with the axes reversed.


Click to EnlargeClick to Enlarge

ShowChart Information

Chart Information
Number of Y values per data point 1
Number of Series 1 or more
Marker Support Series or Data Point
Custom Properties Gap gets or sets the space between the bars of each X axis value.
PointBarDepth Gets or sets the thickness of the 3D bar.

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

ShowTo write the code in Visual Basic.NET

Visual Basic.NET code. Paste INSIDE the section Format event. Copy Code
Me.ChartControl1.Series(0).Properties("Gap") = 65.0F
Me.ChartControl1.Series(0).Properties("PointBarDepth") = 100

ShowTo write the code in C#

C# code. Paste INSIDE the section Format event. Copy Code
this.chartControl1.Series[0].Properties["Gap"] = 65f;
this.chartControl1.Series[0].Properties["PointBarDepth"] = 100;

Line 3D Chart

Use a 3D line chart to compare trends over a period of time or in certain categories in a 3D format.


Click to EnlargeClick to Enlarge

ShowChart Information

Chart Information
Number of Y values per data point 1
Number of Series 1 or more
Marker Support Series or Data Point
Custom Properties LineBackdrop gets or sets the backdrop information for the 3D line.
Thickness gets or sets the thickness of the 3D line.
Width gets or sets the width of the 3D line.

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

ShowTo write the code in Visual Basic.NET

Visual Basic.NET code. Paste INSIDE the section Format event. Copy Code
Me.ChartControl1.Series(0).Properties("LineBackdrop") = New Backdrop(Color.GreenYellow)
Me.ChartControl1.Series(0).Properties("Thickness") = 8.0F
Me.ChartControl1.Series(0).Properties("Width") = 40.0F

ShowTo write the code in C#

C# code. Paste INSIDE the section Format event. Copy Code
this.chartControl1.Series[0].Properties["LineBackdrop"] = new Backdrop(Color.GreenYellow);
this.chartControl1.Series[0].Properties["Thickness"] = 8f;
this.chartControl1.Series[0].Properties["Width"] = 40f;

Pyramid 3D 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 three dimensional format.


Click to EnlargeClick to Enlarge

ShowChart Information

Chart Information
Number of Y values per data point 1
Number of Series 1
Marker Support Series or Data Points
Custom Properties BaseStyle Gets or sets a circular or square base drawing style for the 3D pyramid chart.
CalloutLine 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.
MinPointHeight Gets or sets the minimum height allowed for a data point in the pyramid chart. The height is measured in relative coordinates.
OutsideLabels Gets or sets a value indicating whether the labels are placed outside of the pyramid chart. The default value is True.
OutsideLabelsPlacement 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.
PointGapPct 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.
RotationAngle 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.

ShowTo write the code in Visual Basic.NET

Visual Basic.NET code. Paste ABOVE the report class. Copy Code
Imports DataDynamics.ActiveReports.Chart
Imports DataDynamics.ActiveReports.Chart.Graphics
Visual Basic.NET code. Paste INSIDE the section Format event. 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

ShowTo write the code in C#

C# code. Paste ABOVE the report class. Copy Code
using DataDynamics.ActiveReports.Chart;
using DataDynamics.ActiveReports.Chart.Graphics;
C# code. Paste INSIDE the section Format event. 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;

Stacked Bar 3D Chart

Use a 3D bar graph to compare values of items across categories, allowing the data to be viewed conveniently in a 3D format. A stacked bar graph is a bar graph with two or more data series stacked on top of each other. Use this graph to show how each value contributes to a total.


Click to EnlargeClick to Enlarge

ShowChart Information

Chart Information
Number of Y values per data point 1
Number of Series 1 or more
Marker Support Series or Data Point
Custom Properties Gap gets or sets the space between the bars of each X axis value

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

ShowTo write the code in Visual Basic.NET

Visual Basic.NET code. Paste INSIDE the section Format event. Copy Code
Me.ChartControl1.Series(0).Properties("Gap") = 100.0F

ShowTo write the code in C#

C# code. Paste INSIDE the section Format event. Copy Code
this.chartControl1.Series[0].Properties["Gap"] = 100f;

Stacked Bar 3D 100 Percent Chart

A StackedBar3D100Pct chart is a bar chart with two or more data series stacked one on top the other three dimensionally to sum up to 100%. Use this chart to show how each value contributes to a total with the relative size of each series representing its contribution to the total.


Click to EnlargeClick to Enlarge

ShowChart Information

Chart Information
Number of Y values per data point 1
Number of Series 1 or more
Marker Support Series or Data Point
Custom Properties Gap gets or sets the space between the bars of each X axis value

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

ShowTo write the code in Visual Basic.NET

Visual Basic.NET code. Paste INSIDE the section Format event. Copy Code
Me.ChartControl1.Series(0).Properties("Gap") = 100.0F

ShowTo write the code in C#

C# code. Paste INSIDE the section Format event. Copy Code
this.chartControl1.Series[0].Properties["Gap"] = 100f;

See Also