Pie Chart

• Dec 18, 2018
• 3 minutes to read

The DevExpress PieChart allows you to visualize your data in a Pie (Circular) chart. The image below represents a Pie chart and highlights its major elements.

This guide contains the descriptions of specific operations that can be performed with the PieChart.

How to: Modify chart series

The Chart visualizes data the series provides. Each series defines data appearance and behavior. Series, compatible with the Pie chart inherit the PieSeries class.

Note

Note that chart should be populated with data. Refer to the Series guide for more information.

The following code shows how to add a series to a chart:

Java

PieDataAdapter adapter = new PieDataAdapter();
adapter.add("Asia", 30.13);
adapter.add("Australia", 12.68);
adapter.add("Europe", 21.44);
adapter.add("N. America", 24.06);
adapter.add("S. America", 11.68);

PieSeries pieSeries = new PieSeries();
pieSeries.setDisplayName("Sales Comparison");
pieSeries.setData(adapter);

mChart.addSeries(pieSeries);

// ...
public class PieDataAdapter implements PieSeriesData {
    private List<String> arguments;
    private List<Double> values;

    public PieDataAdapter() {
        arguments = new ArrayList<>();
        values = new ArrayList<>();
    }
    public void add(String arg, Double val) {
        arguments.add(arg);
        values.add(val);
    }
    public int getDataCount() { return arguments.size(); }
    public String getLabel(int index) { return arguments.get(index); }
    public double getValue(int index) { return values.get(index); }
}

C#

PieDataAdapter adapter = new PieDataAdapter();
adapter.add("Asia", 30.13);
adapter.add("Australia", 12.68);
adapter.add("Europe", 21.44);
adapter.add("N. America", 24.06);
adapter.add("S. America", 11.68);

PieSeries pieSeries = new PieSeries();
pieSeries.DisplayName = "Sales Comparison";
pieSeries.Data = adapter;

chart.AddSeries(pieSeries);

//...
class PieDataAdapter : Java.Lang.Object, IPieSeriesData {
    List<string> arguments;
    List<double> values;

    public PieDataAdapter() {
        arguments = new List<string>();
        values = new List<double>();
    }
    public void Add(string arg, double val) {
        arguments.Add(arg);
        values.Add(val);
    } 

    public int DataCount { get { return arguments.Count; } }
    public string GetLabel(int i) { return arguments[i]; }
    public double GetValue(int i) { return values[i]; }
}

The following table contains methods allowing you to obtain, add or remove series of the chart:

Method	Description
PieChart.getSeries()	Returns the array of series that the chart displays.
PieChart.addSeries(PieSeries)	Adds the specified new series to the chart.
PieChart.removeSeries(PieSeries)	Removes the specified series from the chart.
PieChart.removeSeries(int)	Removes a series at the specified index from the chart.

How to: Configure a chart legend

The Legend identifies series in a chart. The following example demonstrates the basic legend configuration:

Java

Legend legend = new Legend();
legend.setOrientation(LegendOrientation.LEFT_TO_RIGHT);
legend.setHorizontalPosition(LegendHorizontalPosition.CENTER);
legend.setVerticalPosition(LegendVerticalPosition.TOP_OUTSIDE);
legend.setVisible(true);
pieChart.setLegend(legend);

C#

Legend legend = new Legend() {
    Orientation = LegendOrientation.LeftToRight,
    HorizontalPosition = LegendHorizontalPosition.Center,
    VerticalPosition = LegendVerticalPosition.TopOutside,
    Visible = true
};
pieChart.Legend = legend;

The table below contains the main methods for configuring the legend:

Method	Description
ChartBase.getLegend()	Returns the chart legend‘s options.
ChartBase.setLegend(Legend)	Specifies the chart legend‘s options.
Legend	The legend of the chart.

Refer to the Legend guide for more information about legend configuration.

How to: Change chart appearance

Appearance of all chart elements including the Pie Chart can be changed using styles. The following image demonstrates which chart parameters can be styled:

The following code snippet demonstrates how to obtain the image above:

Java

PieChartStyle pieChartStyle = new PieChartStyle();
pieChartStyle.setBorderColor(Color.DKGRAY);
pieChartStyle.setBorderThickness(2.0f);
pieChartStyle.setBackgroundColor(Color.LTGRAY);
pieChartStyle.setPalette(new int[] {0xff60a69f, 0xff78b6d9, 0xff6682bb, 0xffa37182, 0xffeeba69});
pieChart.setStyle(pieChartStyle);

C#

PieChartStyle pieChartStyle = new PieChartStyle {
    BorderColor = new Integer(Color.DarkGray),
    BorderThickness = new Float(2.0),
    BackgroundColor = new Integer(Color.LightGray)
};
pieChartStyle.SetPalette(new int[] {
    Color.ParseColor("#ff60a69f"),
    Color.ParseColor("#ff78b6d9"),
    Color.ParseColor("#ff6682bb"),
    Color.ParseColor("#ffa37182"),
    Color.ParseColor("#ffeeba69"),
});
pieChart.Style = pieChartStyle;  

The following symbols allow you to configure chart style:

Symbol	Description
PieChart.getStyle()	Returns the Pie chart’s style.
PieChart.setStyle(PieChartStyle)	Specifies the Pie chart’s style.
PieChartStyle	The Pie chart appearance settings storage.