Back to Devexpress

StackedAreaSeriesView Class

corelibraries-devexpress-dot-xtracharts-c4ef3994.md

latest8.0 KB
Original Source

StackedAreaSeriesView Class

Represents a series view of the Stacked Area type.

Namespace : DevExpress.XtraCharts

Assembly : DevExpress.XtraCharts.v25.2.dll

NuGet Package : DevExpress.Charts

Declaration

csharp
public class StackedAreaSeriesView :
    AreaSeriesView,
    IStackedView
vb
Public Class StackedAreaSeriesView
    Inherits AreaSeriesView
    Implements IStackedView

Remarks

The StackedAreaSeriesView class provides the series view functionality of the stacked area type within a chart control.

The StackedAreaSeriesView class inherits properties and methods from the base AreaSeriesViewBase class which defines common settings of area series views. The StackedAreaSeriesView.MarkerOptions and StackedAreaSeriesView.ColorEach properties are meaningless for this view type due to the specific appearance of the stacked area. They are hidden and always return: MarkerOptions - null , ColorEach - false.

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 stacked area type please see the Stacked Area Chart topic.

Example

The following example demonstrates how to create a ChartControl with two series of the StackedAreaSeriesView type, 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.

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

private void Form1_Load(object sender, EventArgs e) {
    // Create a new chart.
    ChartControl stackedAreaChart = new ChartControl();

    // Create two stacked area series.
    Series series1 = new Series("Series 1", ViewType.StackedArea);
    Series series2 = new Series("Series 2", ViewType.StackedArea);

    // Add points to them.
    series1.Points.Add(new SeriesPoint(1, 10));
    series1.Points.Add(new SeriesPoint(2, 12));
    series1.Points.Add(new SeriesPoint(3, 14));
    series1.Points.Add(new SeriesPoint(4, 17));

    series2.Points.Add(new SeriesPoint(1, 15));
    series2.Points.Add(new SeriesPoint(2, 18));
    series2.Points.Add(new SeriesPoint(3, 25));
    series2.Points.Add(new SeriesPoint(4, 33));

    // Add both series to the chart.
    stackedAreaChart.Series.AddRange(new Series[] { series1, series2 });

    // Set the numerical argument scale types for the series,
    // as it is qualitative, by default.
    series1.ArgumentScaleType = ScaleType.Numerical;
    series2.ArgumentScaleType = ScaleType.Numerical;

    // Access the view-type-specific options of the series.
    ((StackedAreaSeriesView)series1.View).Transparency = 80;

    // Access the type-specific options of the diagram.
    ((XYDiagram)stackedAreaChart.Diagram).EnableAxisXZooming = true;

    // Hide the legend (if necessary).
    stackedAreaChart.Legend.Visible = false;

    // Add a title to the chart (if necessary).
    stackedAreaChart.Titles.Add(new ChartTitle());
    stackedAreaChart.Titles[0].Text = "A Stacked Area Chart";

    // Add the chart to the form.
    stackedAreaChart.Dock = DockStyle.Fill;
    this.Controls.Add(stackedAreaChart);
}
vb
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 a new chart.
    Dim stackedAreaChart As New ChartControl()

    ' Create two stacked area series.
    Dim series1 As New Series("Series 1", ViewType.StackedArea)
    Dim series2 As New Series("Series 2", ViewType.StackedArea)

    ' Add points to them.
    series1.Points.Add(New SeriesPoint(1, 10))
    series1.Points.Add(New SeriesPoint(2, 12))
    series1.Points.Add(New SeriesPoint(3, 14))
    series1.Points.Add(New SeriesPoint(4, 17))

    series2.Points.Add(New SeriesPoint(1, 15))
    series2.Points.Add(New SeriesPoint(2, 18))
    series2.Points.Add(New SeriesPoint(3, 25))
    series2.Points.Add(New SeriesPoint(4, 33))

    ' Add both series to the chart.
    stackedAreaChart.Series.AddRange(New Series() { series1, series2 })

    ' Set the numerical argument scale types for the series,
    ' as it is qualitative, by default.
    series1.ArgumentScaleType = ScaleType.Numerical
    series2.ArgumentScaleType = ScaleType.Numerical

    ' Access the view-type-specific options of the series.
    CType(series1.View, StackedAreaSeriesView).Transparency = 80

    ' Access the type-specific options of the diagram.
    CType(stackedAreaChart.Diagram, XYDiagram).EnableAxisXZooming = True

    ' Hide the legend (if necessary).
    stackedAreaChart.Legend.Visible = False

    ' Add a title to the chart (if necessary).
    stackedAreaChart.Titles.Add(New ChartTitle())
    stackedAreaChart.Titles(0).Text = "A Stacked Area Chart"

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

Implements

IXtraSerializable

IXYSeriesView2D

IXtraSupportDeserializeCollectionItem

ISupportTransparency

Inheritance

Show 17 items

Object ChartElement SeriesViewBase XYDiagram2DSeriesViewBase XYDiagramSeriesViewBase SeriesViewColorEachSupportBase PointSeriesViewBase PointSeriesView LineSeriesView AreaSeriesViewBase AreaSeriesView StackedAreaSeriesView FullStackedAreaSeriesView

StackedSplineAreaSeriesView

StackedStepAreaSeriesView

FullStackedSplineAreaSeriesView

FullStackedStepAreaSeriesView

See Also

StackedAreaSeriesView Members

DevExpress.XtraCharts Namespace