PieSeriesView.RuntimeExploding Property

Specifies whether a user can explode pie slices with the mouse pointer at runtime.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v22.2.dll

NuGet Package: DevExpress.Charts

Declaration

C#

[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public bool RuntimeExploding { get; set; }

VB.NET

<XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)>
Public Property RuntimeExploding As Boolean

Property Value

Type	Description
Boolean	true, if a user can drag pie slices; otherwise, false.

Remarks

The RuntimeExploding property is in effect when the ChartControl.RuntimeHitTesting property is set to true.

The animation below shows how a user can move out a pie slice at runtime:

Use the the PieSeriesViewBase.ExplodedDistancePercentage property to increase/decrease the distance between an exploded slice and the rest of the pie.

C#

private void OnLoad(object sender, EventArgs e) {
    chartControl1.RuntimeHitTesting = true;
    PieSeriesView view = chartControl1.Series[0].View as PieSeriesView;
    view.RuntimeExploding = true;
    view.ExplodedDistancePercentage = 20;
}

VB.NET

Private Sub OnLoad(ByVal sender As Object, ByVal e As EventArgs)
    chartControl1.RuntimeHitTesting = True
    Dim view As PieSeriesView = TryCast(chartControl1.Series(0).View, PieSeriesView)
    view.RuntimeExploding = True
    view.ExplodedDistancePercentage = 20
End Sub

For the WebChartControl, enable RuntimeExploding and add points that a user clicks to the PieSeriesViewBase.ExplodedPoints collection in the WebChartControl.ObjectSelected event handler.

Note

View Demo Online: Pie Series View

C#

protected void WebChartControl1_ObjectSelected(object sender, HotTrackEventArgs e) {
    Series series = e.Object as Series;
    if (series != null) {
        ExplodedSeriesPointCollection explodedPoints = ((PieSeriesViewBase)series.View).ExplodedPoints;
        SeriesPoint point = (SeriesPoint)e.AdditionalObject;
        explodedPoints.ToggleExplodedState(point);
    }
    e.Cancel = series == null;
}

VB.NET

Protected Sub WebChartControl1_ObjectSelected(ByVal sender As Object, ByVal e As HotTrackEventArgs)
    Dim series As Series = TryCast(e.Object, Series)
    If series IsNot Nothing Then
        Dim explodedPoints As ExplodedSeriesPointCollection = (CType(series.View, PieSeriesViewBase)).ExplodedPoints
        Dim point As SeriesPoint = CType(e.AdditionalObject, SeriesPoint)
        explodedPoints.ToggleExplodedState(point)
    End If
    e.Cancel = series Is Nothing
End Sub

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the RuntimeExploding 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.

VB.NET

winforms-charts-create-a-pie-chart/VB/Series_PieChart/Form1.vb#L47

myView.ExplodedDistancePercentage = 30
myView.RuntimeExploding = True
myView.HeightToWidthRatio = 0.75