MPAndroidChartAndroid知识Android开发

MPAndroidChart中文翻译(七设置数据)

2016-10-18  本文已影响674人  鹿小纯0831

本章介绍了如何为各种图表设置数据。

折线图

如果要向图表添加值(数据),则必须通过:

public void setData(ChartData data) { ... }

基类ChartData类封装了在渲染期间图表所需的所有数据和信息。对于不同类型的图表,存在对应的ChartData子类(例如LineData)用于设置图表数据。在构造函数中,你可以提供一个List<? extends IDataSet>作为要显示的值。下面以LineData类(继承自ChartData)为示例,将数据添加到折线图:

/** List constructor */
 public LineData(List<ILineDataSet> sets) { ... } 
/** Constructor with one or multiple ILineDataSet objects */
 public LineData(ILineDataSet...) { ... }

那么,什么是DataSet,为什么你需要它?这实际上很简单。 一个DataSet对象表示图表中属于一起的一组条目(例如,Entry类)。 它用于在逻辑上分隔图表中不同的值组。不同类型的图表都有其对应的继承自DataSet的特定样式的子类对象(例如LineDataSet)。
例如,你可能希望在折线图中显示两个不同公司的一年的季度收入。在这种情况下,建议创建两个不同的LineDataSet对象,每个对象包含四个值(每个季度一个值)。也可以只提供一个LineDataSet对象,包含两个公司的所有8个值。
那么如何设置一个LineDataSet对象呢?

public LineDataSet(List<Entry> entries, String label) { ... }

当查看构造函数(不同的构造函数都可用)时,可以看到,LineDataSet需要一个Entry类型的List和一个用来描述LineDataSet的String和一个用于图例的标签。此外,此标签可用于在LineData对象中的其他LineDataSet对象中查找LineDataSet。
Entry类型的列表封装了图表的所有值。 Entry对象是图表中具有x值和y值的条目附加的包装器:

public Entry(float x, float y) { ... }

综合考虑(两家公司季度收入超过一年的例子):
首先,创建将保存你的值的Entry类型的列表:

List<Entry> valsComp1 = new ArrayList<Entry>();
 List<Entry> valsComp2 = new ArrayList<Entry>();

然后,使用Entry对象填充列表。 确保输入对象包含x轴的正确索引。(当然,这里可以使用循环,在这种情况下,循环的计数器变量可以是x轴上的索引)。

Entry c1e1 = new Entry(0f, 100000f); // 0 == quarter 1 
valsComp1.add(c1e1);
Entry c1e2 = new Entry(1f, 140000f); // 1 == quarter 2 ... 
valsComp1.add(c1e2);
// and so on ...
Entry c2e1 = new Entry(0f, 130000f); // 0 == quarter 1 
valsComp2.add(c2e1);
Entry c2e2 = new Entry(1f, 115000f); // 1 == quarter 2 ... 
valsComp2.add(c2e2);
//...

现在我们有了Entry对象的列表,可以创建LineDataSet对象:

LineDataSet setComp1 = new LineDataSet(valsComp1, "Company 1"); 
setComp1.setAxisDependency(AxisDependency.LEFT);
LineDataSet setComp2 = new LineDataSet(valsComp2, "Company 2"); 
setComp2.setAxisDependency(AxisDependency.LEFT);

通过调用Axis Dependency(...),指定DataSet应该绘制的轴。 最后,我们创建一个DataSet的列表并构建我们的ChartData对象:

// use the interface ILineDataSet
List<ILineDataSet> dataSets = new ArrayList<ILineDataSet>(); 
dataSets.add(setComp1); 
dataSets.add(setComp2); 

LineData data = new LineData(dataSets);
mLineChart.setData(data);
mLineChart.invalidate(); // refresh

调用invalidate()后,图表将刷新并绘制提供的数据。
如果我们要向x轴添加更多描述性值(而不是为不同季度在0到3之间的数字),我们可以使用Axis Value Formatter接口来实现。此接口允许在X轴上绘制自定义样式的值。 在此示例中,格式化程序可能如下所示:

// the labels that should be drawn on the XAxis
final String[] quarters = new String[] { "Q1", "Q2", "Q3", "Q4" };
IAxisValueFormatter formatter = new IAxisValueFormatter() { 

    @Override 
    public String getFormattedValue(float value, AxisBase axis) { 
        return quarters[(int) value]; 
    } 
   // we don't draw numbers, so no decimal digits needed
   @Override 
    public int getDecimalDigits() { return 0; }
};

XAxis xAxis = mLineChart.getXAxis();
xAxis.setGranularity(1f); // minimum axis-step (interval) is 1
xAxis.setValueFormatter(formatter);

有关Axis Value Formatter接口的详细信息,请参见此处
如果应用了附加样式,则此示例生成的折线图应类似于下面的示例:


一般BarChart,ScatterChart,BubbleChart和CandleStickChart的设置数据类似于LineChart。 一个特殊的情况是BarChart有多个(分组)条,这将在下面解释。
条目的顺序

请注意,此库不正式支持未按条目的x位置升序方式绘制折线图数据。以未排序的方式添加条目可能会正确绘图,但也可能出现意外。可以手动或使用条目比较器对条目对象列表进行排序:

List<Entry> entries = ...;
Collections.sort(entries, new EntryXComparator());

这样做是因为使用二进制搜索算法可以更好地处理排序列表,性能更高。

饼图

与其他图表类型不同,饼图以PieEntry对象的形式获取数据。构造函数如下所示:

public PieEntry(float value, String label) { ... }

构造函数的第一个参数用于应该在饼图中绘制为饼形图的实际“值”。第二个参数“label”用于提供对切片的附加描述。
示例代码:

List<PieEntry> entries = new ArrayList<>();

entries.add(new PieEntry(18.5f, "Green"));
entries.add(new PieEntry(26.7f, "Yellow"));
entries.add(new PieEntry(24.0f, "Red"));
entries.add(new PieEntry(30.8f, "Blue"));

PieDataSet set = new PieDataSet(entries, "Election Results");
PieData data = new PieData(set);
pieChart.setData(data);
pieChart.invalidate(); // refresh

PieEntry对象不保存x位置的值,因为图表中显示的PayEntry对象的顺序由它们在条目列表中的顺序确定。图标如下:


上一篇下一篇

猜你喜欢

热点阅读