windowsforms-3996-controls-and-libraries-chart-control-series-views-3d-series-views-area-series-views-stacked-spline-area-chart.md
The Stacked Spline Area Chart is represented by the StackedSplineArea3DSeriesView object, which belongs to Area Series Views. This view is similar to Stacked Area Chart, but plots a fitted curve through each data point in a series.
A Stacked Spline Area chart is shown in the image below.
View Example: Create a 3D Stacked Spline Area Chart
Note
If two stacked areas contain data points for different arguments, points for missing arguments are not treated as zero-value points.
A Stacked Spline Area chart can display series containing data points with positive or negative values. However, a series with positive values is stacked only with other series containing positive values; and a series with negative values is stacked with other series containing negative values.
Note that if a series contains data points with both positive and negative values, it is treated as a series with positive values, while all its negative values are treated as zeros.
The table below lists the main characteristics of this chart type.
| Feature | Value |
|---|---|
| Series View type | StackedSplineArea3DSeriesView |
| Diagram type | XYDiagram3D |
| Number of arguments per series point | 1 |
| Number of values per series point | 1 |
Note
For information on which chart types can be combined with the Stacked Spline Area Chart , refer to the Series Views Compatibility document.
The following example demonstrates how to create a ChartControl with two series of the StackedSplineArea3DSeriesView type, set their 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 stackedSplineArea3DChart = new ChartControl();
// Create two series of the StackedSplineArea3D view type.
Series series1 = new Series("Series 1", ViewType.StackedSplineArea3D);
Series series2 = new Series("Series 2", ViewType.StackedSplineArea3D);
// Populate both series with points.
series1.Points.Add(new SeriesPoint("A", 80));
series1.Points.Add(new SeriesPoint("B", 20));
series1.Points.Add(new SeriesPoint("C", 50));
series1.Points.Add(new SeriesPoint("D", 30));
series2.Points.Add(new SeriesPoint("A", 40));
series2.Points.Add(new SeriesPoint("B", 60));
series2.Points.Add(new SeriesPoint("C", 20));
series2.Points.Add(new SeriesPoint("D", 80));
// Add the series to the chart.
stackedSplineArea3DChart.Series.AddRange(new Series[] {
series1,
series2});
// Adjust the view-type-specific options of the series.
((StackedSplineArea3DSeriesView)series1.View).LineTensionPercent = 10;
((StackedSplineArea3DSeriesView)series2.View).LineTensionPercent = 90;
// Access the diagram's options.
((XYDiagram3D)stackedSplineArea3DChart.Diagram).ZoomPercent = 110;
// Add a title to the chart and hide the legend.
ChartTitle chartTitle1 = new ChartTitle();
chartTitle1.Text = "3D Stacked Spline Area Chart";
stackedSplineArea3DChart.Titles.Add(chartTitle1);
stackedSplineArea3DChart.Legend.Visible = false;
// Add the chart to the form.
stackedSplineArea3DChart.Dock = DockStyle.Fill;
this.Controls.Add(stackedSplineArea3DChart);
}
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 stackedSplineArea3DChart As New ChartControl()
' Create two series of the StackedSplineArea3D view type.
Dim series1 As New Series("Series 1", ViewType.StackedSplineArea3D)
Dim series2 As New Series("Series 2", ViewType.StackedSplineArea3D)
' Populate both series with points.
series1.Points.Add(New SeriesPoint("A", 80))
series1.Points.Add(New SeriesPoint("B", 20))
series1.Points.Add(New SeriesPoint("C", 50))
series1.Points.Add(New SeriesPoint("D", 30))
series2.Points.Add(New SeriesPoint("A", 40))
series2.Points.Add(New SeriesPoint("B", 60))
series2.Points.Add(New SeriesPoint("C", 20))
series2.Points.Add(New SeriesPoint("D", 80))
' Add the series to the chart.
stackedSplineArea3DChart.Series.AddRange(New Series() { series1, series2})
' Adjust the view-type-specific options of the series.
CType(series1.View, StackedSplineArea3DSeriesView).LineTensionPercent = 10
CType(series2.View, StackedSplineArea3DSeriesView).LineTensionPercent = 90
' Access the diagram's options.
CType(stackedSplineArea3DChart.Diagram, XYDiagram3D).ZoomPercent = 110
' Add a title to the chart and hide the legend.
Dim chartTitle1 As New ChartTitle()
chartTitle1.Text = "3D Stacked Spline Area Chart"
stackedSplineArea3DChart.Titles.Add(chartTitle1)
stackedSplineArea3DChart.Legend.Visible = False
' Add the chart to the form.
stackedSplineArea3DChart.Dock = DockStyle.Fill
Me.Controls.Add(stackedSplineArea3DChart)
End Sub
Tip
A complete sample project is available in the DevExpress Code Examples database at https://supportcenter.devexpress.com/ticket/details/e1043/chart-for-winforms-how-to-create-a-3d-stacked-spline-area-chart.
See Also