This topic explains how to configure selection and explosion for the slices of the XamDoughnutChart™ .
The following topics are prerequisites to understanding this topic:
This topic contains the following sections:
The following table lists the configurable aspects of the XamDoughnutChart control related to slice selection.
You can enable (default setting) or disable slice selection in the XamDoughnutChart .
The following table maps the desired behavior to property settings.
The XamDoughnutChart exposes a SelectedStyle property that determines the look of the selected slices. By default, no style is applied, and selecting a slice will not alter its appearance in any way. In order to apply your own style to the selected slices you need to define a Style with TargetType of Slice and set it as the value of the SelectedStyle property.
The following table maps the desired behavior to property settings.
The screenshot below demonstrates how the selected slice (the slice at the top) of the XamDoughnutChart looks as a result of the following settings:
The XamDoughnutChart exposes a SliceClick event used to change the selected/unselected state of a slice.
The following table maps the desired behavior to property settings.
The following code example demonstrates how to toggle the selection state of slices upon click.
In XAML:
<ig:XamDoughnutChart SliceClick="DoughnutSliceClicked">
…In C#:
private void DoughnutSliceClicked(object sender, SliceClickEventArgs e)
{
e.IsSelected = !e.IsSelected;
}In Visual Basic:
Private Sub DoughnutSliceClicked(sender As Object, e As SliceClickEventArgs)
e.IsSelected = Not e.IsSelected
End SubThe XamDoughnutChart holds references to all the slices allowing you to modify their IsSelected property directly to the Slice objects.
The following table maps the desired behavior to property settings.
The following code example demonstrates how to obtain a reference to the first slice of the XamDoughnutChart in order to set its IsSelected property. Note that the execution of this code must occur after loading the particular ring series.
In XAML:
<ig:XamDoughnutChart x:Name="doughnutChart">
<ig:RingSeries Loaded="SeriesLoaded">
…In C#:
private void SeriesLoaded(object sender, RoutedEventArgs e)
{
var firstSlice = ((RingSeries)this.doughnutChart.Series[0]).Ring.ArcItems[0].SliceItems[0].Slice;
firstSlice.IsSelected = true;
}In Visual Basic:
Private Sub SeriesLoaded(sender As Object, e As RoutedEventArgs )
Dim firstSlice = DirectCast(Me.doughnutChart.Series(0), RingSeries).Ring.ArcItems(0).SliceItems(0).Slice
firstSlice.IsSelected = True
End SubAnother approach for managing the selected slices is to modify the contents of the SelectedSlices collection of the XamDoughnutChart . To do this, you need to obtain a reference to one or more Slice objects that you want to select and add them to the SelectedSlices. If you want to unselect slices, remove them from the collection.
The following table maps the desired behaviors to property settings.
The following code example demonstrates how to obtain a reference to the first slice of the XamDoughnutChart in and add it to the collection with selected slices. An example of removing an item is also available. Note, execution of this code must occur after loading the particular ring series.
In XAML:
<ig:XamDoughnutChart x:Name="doughnutChart">
<ig:RingSeries Loaded="SeriesLoaded">
…In C#:
private void SeriesLoaded(object sender, RoutedEventArgs e)
{
var firstSlice = ((RingSeries)this.doughnutChart.Series[0]).Ring.ArcItems[0].SliceItems[0].Slice; {}; "]
// To add a selected item:
this.doughnutChart.SelectedSlices.Add(3);
// To remove a selected item:
this.doughnutChart.SelectedSlices.RemoveAt(3);
}In Visual Basic:
Private Sub SeriesLoaded(sender As Object, e As RoutedEventArgs )
Dim firstSlice = DirectCast(Me.doughnutChart.Series(0), RingSeries).Ring.ArcItems(0).SliceItems(0).Slice
' To add a selected item:
Me.doughnutChart.SelectedSlices.Add(firstSlice)
' To remove a selected item:
Me.doughnutChart.SelectedSlices.RemoveAt(0)
End SubThe following table lists the configurable aspects of the XamDoughnutChart control related to slice explosion.
You can enable (default setting) or disable slice explosion in the XamDoughnutChart .
The following table maps the desired behavior to property settings.
The following screenshot demonstrates a XamDoughnutChart with 1 slice exploded.
The XamDoughnutChart exposes a SliceClick event used to change whether a slice is exploded.
The following table maps the desired behavior to property settings.
The following code example demonstrates how to toggle the explosion state of slices upon click.
In XAML:
<ig:XamDoughnutChart SliceClick="DoughnutSliceClicked">
…In C#:
private void DoughnutSliceClicked(object sender, SliceClickEventArgs e)
{
e.IsExploded = !e.IsExploded;
}In Visual Basic:
Private Sub DoughnutSliceClicked(sender As Object, e As RoutedEventArgs)
e.IsExploded = Not e.IsExploded
End SubThe XamDoughnutChart exposes a SliceClick event used to change whether a slice is exploded.
The following table maps the desired behavior to property settings.
The following code example demonstrates how to obtain a reference to the first slice of the XamDoughnutChart in order to set its IsExploded property. Note that execution of this code must occur after loading the particular ring series.
In XAML:
<ig:XamDoughnutChart x:Name="doughnutChart">
<ig:RingSeries Loaded="SeriesLoaded">
…
</ig:RingSeries>
…
</ig:XamDoughnutChart>In C#:
private void SeriesLoaded(object sender, RoutedEventArgs e)
{
var firstSlice = ((RingSeries)this.doughnutChart.Series[0]).Ring.ArcItems[0].SliceItems[0].Slice;
firstSlice.IsExploded = true;
}In Visual Basic:
Private Sub SeriesLoaded(sender As Object, e As RoutedEventArgs)
Dim firstSlice = DirectCast(Me.doughnutChart.Series(0), RingSeries).Ring.ArcItems(0).SliceItems(0).Slice
firstSlice.IsExploded = True
End SubAnother approach for managing the exploded slices is to modify the contents of the ExplodedSlices collection of the XamDoughnutChart . To do this, you need to obtain a reference to one or more Slice objects that you want to be able to explode and add them to the ExplodedSlices. If you want to set the non-exploded state of slices, remove them from the collection.
The following table maps the desired behavior to property settings.
The following code example demonstrates how to obtain a reference to the first slice of the XamDoughnutChart in and add it to the collection with exploded slices. An example for removing an item is also available. Note, execution of this code must occur after loading the particular ring series.
In XAML:
<ig:XamDoughnutChart x:Name="doughnutChart">
<ig:RingSeries Loaded="SeriesLoaded">
…
</ig:RingSeries>
…
</ig:XamDoughnutChart>In C#:
private void SeriesLoaded(object sender, RoutedEventArgs e)
{
var firstSlice = ((RingSeries)this.doughnutChart.Series[0]).Ring.ArcItems[0].SliceItems[0].Slice;
// To add an exploded item:
this.doughnutChart.ExplodedSlices.Add(firstSlice);
// To remove an exploded item:
this.doughnutChart.ExplodedSlices.RemoveAt(0);
}In Visual Basic:
Private Sub SeriesLoaded(sender As Object, e As RoutedEventArgs )
Dim firstSlice = DirectCast(Me.doughnutChart.Series(0), RingSeries).Ring.ArcItems(0).SliceItems(0).Slice
' To add an exploded item:
Me.doughnutChart.ExplodedSlices.Add(firstSlice)
' To remove an exploded item:
Me.doughnutChart.ExplodedSlices.RemoveAt(0)
End Sub