Android报表库aChartEngine系列（pie chart）

1、pie chart介绍

aChartEngine中的pie Chart其实就是一个饼状图，是数据显示的一种。效果如图：



2、如何使用pie chart。

其实aChartEngine是使用是非常简单的，不同的chart的使用方式都是一样的，并不需要我们根据不同的chart调用不同的接口，接口都是统一的。那么我们应该如何使用呢？总结了一下分为两步：

①获取数据dataSet；

②获取渲染器render。

其实这很好理解，一个图表其实本来就是一些数据的显示方式。所以你必须得有数据（dataset），有了数据之后你总得知道应该以什么样的方式来显示吧（render）。这么看来这两部分是缺一不可的，而且功能很明确。

3、demo。

package com.example.test;

import org.achartengine.ChartFactory;
import org.achartengine.model.CategorySeries;
import org.achartengine.renderer.DefaultRenderer;
import org.achartengine.renderer.SimpleSeriesRenderer;

import android.app.Activity;
import android.graphics.Color;
import android.os.Bundle;
import android.view.View;

public class MainActivity extends Activity {

@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
double[] values = new double[] { 12, 14, 11, 10, 19 };
int[] colors = new int[] { Color.BLUE, Color.GREEN, Color.MAGENTA, Color.YELLOW, Color.CYAN };
DefaultRenderer renderer = buildCategoryRenderer(colors);
renderer.setZoomButtonsVisible(true);
renderer.setZoomEnabled(true);
renderer.setChartTitleTextSize(20);
//        Intent intent = ChartFactory.getPieChartIntent(this, buildCategoryDataset("Project budget", values), renderer, "Budget");
//        startActivity(intent);
View view = ChartFactory.getPieChartView(this, buildCategoryDataset("Project budget", values), renderer);
view.setBackgroundColor(Color.BLACK);
setContentView(view);
}

protected DefaultRenderer buildCategoryRenderer(int[] colors) {
DefaultRenderer renderer = new DefaultRenderer();
renderer.setLabelsTextSize(15);
renderer.setLegendTextSize(15);
renderer.setMargins(new int[] { 20, 30, 15, 0 });
for (int color : colors) {
SimpleSeriesRenderer r = new SimpleSeriesRenderer();
r.setColor(color);
renderer.addSeriesRenderer(r);
}
return renderer;
}

protected CategorySeries buildCategoryDataset(String title, double[] values) {
CategorySeries series = new CategorySeries(title);
int k = 0;
for (double value : values) {
series.add("Project " + ++k + " (" + value + ")", value);
}
return series;
}
}

4、分析demo。

代码中比较关键的地方其实是 ChartFactory.getPieChartView，它返回一个view，也就是我们需要显示的chart。那么我们看看这个方法（在doc上有开发说明）：

public static final GraphicalView getPieChartView(android.content.Context context,
CategorySeries dataset,
DefaultRenderer renderer)

Creates a pie chart intent that can be used to start the graphical view activity.

Parameters:

context

- the context

dataset

- the category series dataset (cannot be null)

renderer

- the series renderer (cannot be null)Returns:a pie chart viewThrows:

java.lang.IllegalArgumentException

- if dataset is null or renderer is null or if the dataset number of items is different than the number of series renderer。
所以需要两个非常重要的参数，也就是开始我们提到的dataset、renderer。具体是如何构造的见代码。

这里需要值一提的是dataset中的item数应该和renderer中的SeriesRenderer数相等。每组数据应该对已一个renderer，也就是说每一组数据都应有自己独立的显示样式。

5、总结。

pie Chart 是achartengine里面最简单的chart，使用起来很方便。它需要的dataset中需要离散的几个数，而不是离散的几个点。

在使用上面的代码前一定要引入achartengine1.0.0.jar包，如果运行时有找不到类、类定义这样的问题，也许我的博文/article/5145990.html可以帮助到你。

我的另一篇博文/article/5145997.html对achartengine做了简单的介绍。

欢迎交流。期待你的宝贵意见。