Back to Devexpress

SeriesBase.View Property

corelibraries-devexpress-dot-xtracharts-dot-seriesbase-a64154b5.md

latest11.0 KB
Original Source

SeriesBase.View Property

Gets or sets the view that the series uses to visualize its data.

Namespace : DevExpress.XtraCharts

Assembly : DevExpress.XtraCharts.v25.2.dll

NuGet Package : DevExpress.Charts

Declaration

csharp
[XtraChartsLocalizableCategory(XtraChartsCategory.Elements)]
public SeriesViewBase View { get; set; }
vb
<XtraChartsLocalizableCategory(XtraChartsCategory.Elements)>
Public Property View As SeriesViewBase

Property Value

TypeDescription
SeriesViewBase

A SeriesViewBase-derived object that represents the view type of the series.

|

Remarks

The XtraChart control features multiple series types which allow you to represent data in various forms (Bar, Stacked Bar, Pie, Point and Line series). Use the View property to specify the desired view type for the series.

Each series view type is represented by a specific object which inherits from the base SeriesViewBase class. The View property provides access to the corresponding type specific settings of the series view object (note that for this purpose the property’s value should by type cast to a proper series view type).

Note that the view type of a series can also be changed easily at runtime by using the series’s SeriesBase.ChangeView method.

Example

The following example demonstrates how to create a ChartControl with two series of the AreaSeriesView type, and add this chart to a form at runtime. Before proceeding with this example, create a Windows Forms Application in Visual Studio, and add all required assemblies to the References list of your project.

Then, add the following code to the Form.Load event handler.

csharp
using DevExpress.XtraCharts;
// ...

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

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

    // Add points to them.
    series1.Points.Add(new SeriesPoint(1, 15));
    series1.Points.Add(new SeriesPoint(2, 18));
    series1.Points.Add(new SeriesPoint(3, 25));
    series1.Points.Add(new SeriesPoint(4, 33));

    series2.Points.Add(new SeriesPoint(1, 10));
    series2.Points.Add(new SeriesPoint(2, 12));
    series2.Points.Add(new SeriesPoint(3, 14));
    series2.Points.Add(new SeriesPoint(4, 17));

    // Add both series to the chart.
    areaChart.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.
    ((AreaSeriesView)series1.View).Transparency = 80;

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

    // Hide the legend (optional).
    areaChart.Legend.Visible = false;

    // Add the chart to the form.
    areaChart.Dock = DockStyle.Fill;
    this.Controls.Add(areaChart);
}
vb
Imports DevExpress.XtraCharts
' ...

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) _
Handles MyBase.Load
    ' Create a new chart.
    Dim areaChart As New ChartControl()

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

    ' Add points to them.
    series1.Points.Add(New SeriesPoint(1, 15))
    series1.Points.Add(New SeriesPoint(2, 18))
    series1.Points.Add(New SeriesPoint(3, 25))
    series1.Points.Add(New SeriesPoint(4, 33))

    series2.Points.Add(New SeriesPoint(1, 10))
    series2.Points.Add(New SeriesPoint(2, 12))
    series2.Points.Add(New SeriesPoint(3, 14))
    series2.Points.Add(New SeriesPoint(4, 17))

    ' Add both series to the chart.
    areaChart.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, AreaSeriesView).Transparency = 80

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

    ' Hide the legend (optional).
    areaChart.Legend.Visible = False

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

The following code snippets (auto-collected from DevExpress Examples) contain references to the View 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.

webchartcontrol-how-to-change-auto-created-series-appearance/CS/BoundDataChangedExample/WebForm1.aspx.cs#L20

csharp
webChartControl.DataBind();
webChartControl.SeriesTemplate.View = new SideBySideBarSeriesView();
webChartControl.BoundDataChanged += WebChartControl_BoundDataChanged;

wpf-dashboard-custom-properties/CS/Wpf-Dashboard-Custom-Properties/Modules/ChartItemModule/ChartOptions/LineStyle.cs#L64

csharp
foreach(var chartSeries in context.GetControlSeries(series)) {
    DevExpress.XtraCharts.LineSeriesView view = chartSeries.View as DevExpress.XtraCharts.LineSeriesView;
    if(view != null)

winforms-charts-show-chart-legend-with-markers-in-separate-control/CS/Form1.cs#L61

csharp
diagram.DefaultPane.Visibility = ChartElementVisibility.Hidden;
SeriesViewColorEachSupportBase colorEachView = currentSeries.View as SeriesViewColorEachSupportBase;
if (colorEachView != null && colorEachView.ColorEach)

asp-net-web-forms-web-chart-control-create-drill-down-chart/CS/DrillDownChart/WebForm1.aspx.cs#L35

csharp
if (diagram != null) {
    if (e.Series[0].View is StackedBarSeriesView) {
        diagram.Rotated = true;

winforms-charts-sort-stacked-bars-by-total-values-with-qualitativescalecomparer/CS/Form1.cs#L21

csharp
var stackedBarSeriesView = new StackedBarSeriesView();
seriesTemplate.View = stackedBarSeriesView;
stackedBarSeriesView.Pane.StackedBarTotalLabel.Visible = true;

webchartcontrol-how-to-change-auto-created-series-appearance/VB/BoundDataChangedExample/WebForm1.aspx.vb#L23

vb
webChartControl.DataBind()
webChartControl.SeriesTemplate.View = New SideBySideBarSeriesView()
AddHandler webChartControl.BoundDataChanged, AddressOf WebChartControl_BoundDataChanged

wpf-dashboard-custom-properties/VB/Wpf-Dashboard-Custom-Properties/Modules/ChartItemModule/ChartOptions/LineStyle.vb#L64

vb
For Each chartSeries In context.GetControlSeries(series)
    Dim view As DevExpress.XtraCharts.LineSeriesView = TryCast(chartSeries.View, DevExpress.XtraCharts.LineSeriesView)
    If view IsNot Nothing Then

winforms-charts-show-chart-legend-with-markers-in-separate-control/VB/Form1.vb#L56

vb
If diagram IsNot Nothing Then diagram.DefaultPane.Visibility = ChartElementVisibility.Hidden
Dim colorEachView As SeriesViewColorEachSupportBase = TryCast(currentSeries.View, SeriesViewColorEachSupportBase)
If colorEachView IsNot Nothing AndAlso colorEachView.ColorEach Then

asp-net-web-forms-web-chart-control-create-drill-down-chart/VB/DrillDownChart/WebForm1.aspx.vb#L36

vb
If diagram IsNot Nothing Then
    If TypeOf e.Series(0).View Is StackedBarSeriesView Then
        diagram.Rotated = True

winforms-charts-sort-stacked-bars-by-total-values-with-qualitativescalecomparer/VB/Form1.vb#L22

vb
Dim stackedBarSeriesView = New StackedBarSeriesView()
seriesTemplate.View = stackedBarSeriesView
stackedBarSeriesView.Pane.StackedBarTotalLabel.Visible = True

See Also

ChangeView(ViewType)

SeriesBase Class

SeriesBase Members

DevExpress.XtraCharts Namespace