android 功能代码-----Android报表控件achartengine介绍(一)

AChartEngine是一个针对Android程序开发的免费图表开发库，目前已经发布了4个版本。支持散点图、折线图、饼图、气泡图、柱状图、短棒图、仪表图等多种图表。Android开发者可以很方便的试用AChartEngine Chart库画出各种图表。

该项目地址位于：

http://code.google.com/p/achartengine/

你可以选择合适的版本下载，每个版本都有一个jar包、实例源代码和java doc提供下载。当前最新版本为1.0。








更详细的介绍请查看/article/1356490.html



在下载的achartengine-1.0.0-demo-source官方的demo文档里面有了详细的代码演示了使用

其demo 类模型如下

1. ChartDemo这个类是整个应用程序的入口,运行之后的效果显示一个list.

2. IDemoChart接口,这个接口定义了三个方法,

getName()返回值是listitem上显示的标题;

getDesc()返回值是listitem上显示的描述内容.

excute(context)返回值是一个Intent,当点击listitem后跳转到此Intent.

3. AbstractDemoChart类是一个抽象类,实现接口IDemoChart接口,这个类中封装了构建DataSet和renderer的方法,目的快速构建我们的dataset和renderer.

Java代码







/**
* 报表统一信息接口
* *
*/
public interface IChart {

String NAME = "name";
String DESC = "desc";

/**
* 报表名
*
* @return
*/
String getName();

/**
* 报表描述
*
* @return
*/
String getDesc();

/**
* 返回值是一个Intent,当点击后跳转到此Intent.
*
* @param context
* @return
*/
Intent execute(Context context);
}

/**
 * 报表统一信息接口
 *  * 
 */
public interface IChart {

	String NAME = "name";
	String DESC = "desc";

	/**
	 * 报表名
	 * 
	 * @return
	 */
	String getName();

	/**
	 * 报表描述
	 * 
	 * @return
	 */
	String getDesc();

	/**
	 * 返回值是一个Intent,当点击后跳转到此Intent.
	 * 
	 * @param context
	 * @return
	 */
	Intent execute(Context context);
}

Java代码







/**
* *
*/
public abstract class AbstractChart implements IChart {

/**
* Builds an XY multiple dataset using the provided values. 构建

* XYMultipleSeriesDataset
*
* @param titles
* 每个序列的图例
* @param xValues
* X轴的坐标
*
* @param yValues
* y轴的坐标
*
* @return the XY multiple dataset
*/
protected XYMultipleSeriesDataset buildDataset(String[] titles, List<double[]> xValues, List<double[]> yValues) {
XYMultipleSeriesDataset dataset = new XYMultipleSeriesDataset();
addXYSeries(dataset, titles, xValues, yValues, 0);
return dataset;
}

// 向DataSet中添加序列.
public void addXYSeries(XYMultipleSeriesDataset dataset, String[] titles, List<double[]> xValues, List<double[]> yValues, int scale) {

int length = titles.length;
for (int i = 0; i < length; i++) {
XYSeries series = new XYSeries(titles[i], scale);// 这里注意与TimeSeries区别.

double[] xV = xValues.get(i);
double[] yV = yValues.get(i);
int seriesLength = xV.length;
for (int k = 0; k < seriesLength; k++) {
series.add(xV[k], yV[k]);
}
dataset.addSeries(series);
}
}

/**
* Builds an XY multiple series renderer. 构建XYMultipleSeriesRenderer.

*
* @param colors
* 每个序列的颜色
* @param styles
* 每个序列点的类型(可设置三角,圆点,菱形,方块等多种)

* @return XYMultipleSeriesRenderer
*/
protected XYMultipleSeriesRenderer buildRenderer(int[] colors, PointStyle[] styles) {
XYMultipleSeriesRenderer renderer = new XYMultipleSeriesRenderer();
setRenderer(renderer, colors, styles);
return renderer;
}

// 整个图表属性设置

protected void setRenderer(XYMultipleSeriesRenderer renderer, int[] colors, PointStyle[] styles) {
// -->start
renderer.setAxisTitleTextSize(16);// 设置轴标题文字的大小

renderer.setChartTitleTextSize(20); // 设置整个图表标题文字的大小

renderer.setLabelsTextSize(15); // 设置轴刻度文字的大小

renderer.setLegendTextSize(15);// 设置图例文字大小

renderer.setPointSize(5f);// 设置点的大小(图上显示的点的大小和图例中点的大小都会被设置)

renderer.setMargins(new int[] { 20, 30, 15, 20 });// 设置图表的外边框(上/左/下/右)

// -->end

// 以下代码设置每个序列的颜色.
// -->start
int length = colors.length;
for (int i = 0; i < length; i++) {
XYSeriesRenderer r = new XYSeriesRenderer();
r.setColor(colors[i]);// 设置颜色

r.setPointStyle(styles[i]);
renderer.addSeriesRenderer(r);
}
// -->end

}

/**
* 设置renderer的一些属性.
*
* @param renderer
* 要设置的renderer
* @param title
* 图表标题
* @param xTitle
* X轴标题
* @param yTitle
* Y轴标题
* @param xMin
* X轴最小值
* @param xMax
* X轴最大值
* @param yMin
* Y轴最小值
* @param yMax
* Y轴最大值
* @param axesColor
* X轴颜色
* @param labelsColor
* Y轴颜色
*/

protected void setChartSettings(XYMultipleSeriesRenderer renderer, String title, String xTitle, String yTitle, double xMin, double xMax, double yMin, double yMax, int axesColor, int labelsColor) {

renderer.setChartTitle(title);
renderer.setXTitle(xTitle);
renderer.setYTitle(yTitle);
renderer.setXAxisMin(xMin);
renderer.setXAxisMax(xMax);
renderer.setYAxisMin(yMin);
renderer.setYAxisMax(yMax);
renderer.setAxesColor(axesColor);
renderer.setLabelsColor(labelsColor);
}

/**
* 构建和时间有关的XYMultipleSeriesDataset,这个方法与buildDataset在参数上区别是需要List<Date[]>作参数

* .
*
* @param titles
* 序列图例
* @param xValues
* X轴值
* @param yValues
* Y轴值
* @return XYMultipleSeriesDataset
*/

protected XYMultipleSeriesDataset buildDateDataset(String[] titles, List<Date[]> xValues, List<double[]> yValues) {
XYMultipleSeriesDataset dataset = new XYMultipleSeriesDataset();
int length = titles.length;
for (int i = 0; i < length; i++) {
TimeSeries series = new TimeSeries(titles[i]);// 构建时间序列TimeSeries

Date[] xV = xValues.get(i);
double[] yV = yValues.get(i);
int seriesLength = xV.length;
for (int k = 0; k < seriesLength; k++) {
series.add(xV[k], yV[k]);
}
dataset.addSeries(series);
}
return dataset;
}

/**
* 构建单个CategorySeries,可用于生成饼图,注意与buildMultipleCategoryDataset(构建圆环图)相区别.

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

return series;
}

/**
* 构建MultipleCategorySeries,可用于构建圆环图(每个环是一个序列)

*
* @param titles
* the series titles
* @param values
* the values
* @return the category series
*/
protected MultipleCategorySeries buildMultipleCategoryDataset(String title, List<String[]> titles, List<double[]> values) {
MultipleCategorySeries series = new MultipleCategorySeries(title);
int k = 0;
for (double[] value : values) {
series.add(2007 + k + "", titles.get(k), value);
k++;
}
return series;
}

/**
* 构建DefaultRenderer.
*
* @param colors
* 每个序列的颜色
* @return DefaultRenderer
*/
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;
}

/**
* 构建XYMultipleSeriesDataset,适用于柱状图.
*
* @param titles
* 每中柱子序列的图列
* @param values
* 柱子的高度值
* @return XYMultipleSeriesDataset
*/
protected XYMultipleSeriesDataset buildBarDataset(String[] titles, List<double[]> values) {
XYMultipleSeriesDataset dataset = new XYMultipleSeriesDataset();
int length = titles.length;
for (int i = 0; i < length; i++) {
CategorySeries series = new CategorySeries(titles[i]);
double[] v = values.get(i);
int seriesLength = v.length;
for (int k = 0; k < seriesLength; k++) {
series.add(v[k]);
}
dataset.addSeries(series.toXYSeries());
}
return dataset;
}

/**
* 构建XYMultipleSeriesRenderer,适用于柱状图.

*
* @param colors
* 每个序列的颜色
* @return XYMultipleSeriesRenderer
*/
protected XYMultipleSeriesRenderer buildBarRenderer(int[] colors) {
XYMultipleSeriesRenderer renderer = new XYMultipleSeriesRenderer();
renderer.setAxisTitleTextSize(16);
renderer.setChartTitleTextSize(20);
renderer.setLabelsTextSize(15);
renderer.setLegendTextSize(15);
int length = colors.length;
for (int i = 0; i < length; i++) {
SimpleSeriesRenderer r = new SimpleSeriesRenderer();
r.setColor(colors[i]);
renderer.addSeriesRenderer(r);
}
return renderer;
}
}