SeriesBase.ChangeView(ViewType) Method

Changes the series’ view type by specifying its type.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v20.2.dll

NuGet Packages: DevExpress.Charts, DevExpress.WindowsDesktop.Charts

Declaration

C#

public void ChangeView(
    ViewType viewType
)

VB.NET

Public Sub ChangeView(
    viewType As ViewType
)

Parameters

Name	Type	Description
viewType	ViewType	A ViewType enumeration value.

Remarks

The ChangeView method can be used to change the view type of a series object by specifying the required type of a series view.

A call to this method affects the value of the series’ SeriesBase.View property.

Example

The following example demonstrates how to programmatically change the current series view via the SeriesBase.ChangeView method. Note that this method is better than directly changing the SeriesBase.View property, because the ChangeView is implemented in a way that saves the property values of the old view to the greatest degree possible.

C#

using DevExpress.XtraCharts;
// ...

public void ToPie(SeriesBase series) {
    series.ChangeView(ViewType.Pie);
}

public void ToBars(SeriesBase series) {
    series.ChangeView(ViewType.Bar);
}

VB.NET

Imports DevExpress.XtraCharts
' ...

Public Sub ToPie(series As SeriesBase)
   series.ChangeView(ViewType.Pie)
End Sub

Public Sub ToBars(series As SeriesBase)
   series.ChangeView(ViewType.Bar)
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ChangeView(ViewType) method.

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.

C#

how-to-check-whether-the-series-with-the-different-view-types-are-compatible-e1321/CS/CheckCompatibility/Form1.cs#L30

if(IsCompatible(this.chartControl1, ViewType.Area))
    this.chartControl1.Series[0].ChangeView(ViewType.Area);
else

how-to-individually-change-the-view-type-of-an-auto-created-series-e1518/CS/ChangeViewOfAnAutoSeries/Form1.cs#L70

if (feb != null)
    feb.ChangeView(ViewType.Line);

winforms-pivot-chart-integration-hide-unnecessary-series-from-the-chart/CS/WindowsApplication53/Form1.cs#L26

chartControl1.SeriesTemplate.ChangeView(DevExpress.XtraCharts.ViewType.Line);

how-to-customize-the-chart-wizard-e1660/CS/CustomChartTypeUserControl.cs#L30

try {
    ((ChartControl)CurrentChartControl).Series[0].ChangeView((ViewType)imageListBoxControl1.SelectedValue);
}

winforms-charts-link-chart-to-pivotgrid/CS/Pivot_Chart_1/Form1.cs#L24

private void chartControl1_BoundDataChanged(object sender, EventArgs e) {
    ((ChartControl)sender).SeriesTemplate.ChangeView(ViewType.Line);
}

VB.NET

how-to-check-whether-the-series-with-the-different-view-types-are-compatible-e1321/VB/CheckCompatibility/Form1.vb#L27

If IsCompatible(Me.chartControl1, ViewType.Area) Then
    Me.chartControl1.Series(0).ChangeView(ViewType.Area)
Else

how-to-individually-change-the-view-type-of-an-auto-created-series-e1518/VB/ChangeViewOfAnAutoSeries/Form1.vb#L71

If feb IsNot Nothing Then
    feb.ChangeView(ViewType.Line)
End If

winforms-pivot-chart-integration-hide-unnecessary-series-from-the-chart/VB/WindowsApplication53/Form1.vb#L21

    pivotGridControl1.BestFit()
    chartControl1.SeriesTemplate.ChangeView(ViewType.Line)
End Sub

how-to-customize-the-chart-wizard-e1660/VB/CustomChartTypeUserControl.vb#L32

Try
    CType(CurrentChartControl, ChartControl).Series(0).ChangeView(CType(imageListBoxControl1.SelectedValue, ViewType))
Catch ex As Exception

winforms-charts-link-chart-to-pivotgrid/VB/Pivot_Chart_1/Form1.vb#L26

Private Sub chartControl1_BoundDataChanged(ByVal sender As Object, ByVal e As EventArgs) Handles chartControl1.BoundDataChanged
    DirectCast(sender, ChartControl).SeriesTemplate.ChangeView(ViewType.Line)
End Sub