Pie
Unlike all other series, PieSeries do not require axes. They visualize each data point as a pie slices with arc size directly proportional to the magnitude of the raw data point’s value. It is important to note that the pie series are valid only in the context of Pie AreaType. Pie slices represent data in one dimension contrasting with the other series which represent data in two dimensions. Here is an example of how to create a pie chart with pie series populated with data:
Initial Setup
this.radChartView1.AreaType = ChartAreaType.Pie;
PieSeries series = new PieSeries();
series.DataPoints.Add(new PieDataPoint(50, "Germany"));
series.DataPoints.Add(new PieDataPoint(70, "United States"));
series.DataPoints.Add(new PieDataPoint(40, "France"));
series.DataPoints.Add(new PieDataPoint(25, "United Kingdom"));
series.ShowLabels = true;
this.radChartView1.Series.Add(series);
Me.RadChartView1.AreaType = ChartAreaType.Pie
Dim series As New PieSeries()
series.DataPoints.Add(New PieDataPoint(50, "Germany"))
series.DataPoints.Add(New PieDataPoint(70, "United States"))
series.DataPoints.Add(New PieDataPoint(40, "France"))
series.DataPoints.Add(New PieDataPoint(25, "United Kingdom"))
series.ShowLabels = True
Me.RadChartView1.Series.Add(series)
Figure 1: Initial Setup
PieSeries can be customized using the following properties:
- Range: The property consists of two parameters StartAngle and SweepAngle. StartAngle sets the angle in degrees from which the drawing of the pie segments will begin. Note that pie slices are always rendered in clockwise direction. SweepAngle determines if the chart will appear as a full circle or a partial circle.The snippet below illustrates PieSeries how to set the Range property:
AngleRange range = new AngleRange(270, 300);
series.Range = range;
Dim range As New AngleRange(270, 300)
series.Range = range
Figure 2: Angle Range
ShowLabels: The property determines whether the labels above each point will be visible.
-
LabelMode: Gets or sets the label mode of the PieSeries. The user can choose one of the following options:
- Horizontal - Each label is renderred horizontally. Its position from the center of its corresponding pie segment is determined by X property.
- Radial - Each label is renderred radial to its corresponding Pie segment. Its position from the center of the chart is determined by X property.
RadiusFactor: The property can increase and decrease the diameter of the series. Setting the RadiusFactor to 0.9 will decrease the radius of the series by 10 percent. Similarly, the value 1.1 will increase it. Leaving the property with value 1 will make the donut fill the available space.
Additionally, PieSeries allows offsetting a pie segment from the rest of the slices. This is achieved through the OffsetFromCenter property of the individual PieDataPoint. The following snippet demonstrates how to shift the first pie piece:
Offset Segment
PieDataPoint point = series.DataPoints[3] as PieDataPoint;
if (point != null)
{
point.OffsetFromCenter = 0.1;
}
Dim point As PieDataPoint = TryCast(series.DataPoints(3), PieDataPoint)
If point IsNot Nothing Then
point.OffsetFromCenter = 0.1
End If
Figure 3: Offset Segment
