本章主题是介绍为各种图表设置数据

线型图

如果要将值（数据）添加到图表中，则必须通过

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

基类ChartData（）类封装了呈现期间图表所需的所有数据和信息。对于每种类型的图表，存在应该用于设置图表数据的不同子类ChartData（例如LineData）。在构造函数中，您可以将一个List<? extends IDataSet>作为要显示的值移交。下面是类LineData（extends ChartData）的示例，用于将数据添加到LineChart：

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

那么，什么是DataSet，需要它的原因是什么？这实际上非常简单。一个DataSet对象表示Entry图表中属于一起的一组条目（例如，类条目）。它旨在逻辑上分离图表中的不同值组。对于每种类型的图表，存在允许特定样式的扩展DataSet（例如LineDataSet）的不同对象。

例如，您可能希望在一年内显示两年内两家公司的季度收入LineChart。在这种情况下，建议创建两个不同的LineDataSet对象，每个对象包含四个值（每个季度一个）。

当然，也可以只提供一个LineDataSet包含两个公司的所有8个值的对象。

那么如何设置LineDataSet对象呢？

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

当查看构造函数（不同的构造函数可用）时，可以看到LineDataSet需要一个类型为Entry的List和一个用于描述LineDataSet的String以及一个用于Legend的标签。此外，该标签可用于在LineData对象中的其他LineDataSet对象中查找LineDataSet。

Entry类型列表封装了图表的所有值。Entry对象是图表中具有x值和y值的条目的附加包装器：

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

总而言之（两家公司的季度收入超过一年的例子）：

首先，创建将保存您的值的Entry类型列表：

List
     
       valsComp1 = new ArrayList
      
       ();   List
       
         valsComp2 = new ArrayList
        
         ();
        
       
      
     

然后，用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);

通过调用setAxisDependency(...)，DataSet指定应绘制的轴。最后但同样重要的是，我们创建了一个IDataSets列表并构建了我们的ChartData对象：

// use the interface ILineDataSet    List
     
       dataSets = new ArrayList
      
       ();    dataSets.add(setComp1);    dataSets.add(setComp2);        LineData data = new LineData(dataSets);    mLineChart.setData(data);    mLineChart.invalidate(); // refresh
      
     

调用invalidate()图表后刷新并绘制提供的数据。

如果我们想要为x轴添加更多描述性值（而不是不同季度的0到3之间的数字），我们可以通过使用IAxisValueFormatter接口来实现。此接口允许自定义XAxis上绘制的值的样式。在此示例中，formatter可能如下所示：

// the labels that should be drawn on the XAxisfinal 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 1xAxis.setValueFormatter(formatter);

有关IAxisValueFormatter界面的详细信息，请参见。

如果应用了其他样式，此示例生成的LineChart应类似于下面的那个：

设置标准BarChart，ScatterChart，BubbleChart和CandleStickChart的数据类似于LineChart。一个特例是BarChart带有多个（分组）条形，下面将对其进行说明。

条目的顺序

请注意，此库没有正式支持从未按条目的x位置升序方式排序的LineChart的Entry列表中绘制数据。以未排序的方式添加条目可能会正确绘制，但也可能导致意外行为。List的Entry对象可以使用手动进行排序或使用EntryXComparator：

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

之所以需要这样做是因为该库使用以获得更好的性能，仅用于排序列表。

BarChart

为BarChart设置数据的方式与LineChart非常相似。主要区别是需要用于设置数据的数据对象（例如，BarEntry而不是Entry）。除此之外，BarChart还有不同的类型选择。

请考虑以下填充BarChart数据的示例：

List
     
       entries = new ArrayList<>();entries.add(new BarEntry(0f, 30f));entries.add(new BarEntry(1f, 80f));entries.add(new BarEntry(2f, 60f));entries.add(new BarEntry(3f, 50f));                                     // gap of 2fentries.add(new BarEntry(5f, 70f));entries.add(new BarEntry(6f, 60f));BarDataSet set = new BarDataSet(entries, "BarDataSet");
     

在上面的示例中，BarEntry创建了五个对象并将其添加到一个 BarDataSet。请注意，第四个和第五个条目之间的x位置存在“2”的间隙。在这个例子中，这个间距用于解释BarChart中柱的定位是如何工作的。本教程末尾的屏幕截图将显示BarChart给定数据的结果。下一步，BarData需要创建一个对象：

BarData data = new BarData(set);data.setBarWidth(0.9f); // set custom bar widthchart.setData(data);chart.setFitBars(true); // make the x-axis fit exactly all barschart.invalidate(); // refresh

在上面的代码片段中，创建了一个BarData对象。创建图表的BarEntry对象时，我们在每个条形（中心）之间的x轴上留下了“1f”的空间。通过将条宽设置为0.9f，我们有效地在每个条之间创建0.1f的空间。该setFitBars(true)调用将告诉图表调整其x轴值的范围以完全适合所有条形，并且两侧不会切断条形。

创建BarData对象后，我们将其设置为图表并刷新。结果应该看起来接近下面显示的结果：

Grouped BarChart

从版本，MPAndroidChart支持明确分组的绘图条（在这种情况下，库将处理x位置）或用户定义，这意味着用户可以通过更改x轴位置将条型放置在他想要的任何位置。

本节将重点介绍显式分组BarChart，这意味着库将处理条形的x轴位置。请考虑以下示例设置：

YourData[] group1 = ...;YourData[] group2 = ...;List
     
       entriesGroup1 = new ArrayList<>();List
      
        entriesGroup2 = new ArrayList<>();// fill the listsfor(int i = 0; i < group1.length; i++) {    entriesGroup1.add(new BarEntry(i, group1.getValue()));    entriesGroup2.add(new BarEntry(i, group2.getValue()));}BarDataSet set1 = new BarDataSet(entriesGroup1, "Group 1");BarDataSet set2 = new BarDataSet(entriesGroup2, "Group 2");
      
     

在这个示例中，我们将有两组条形图，每个都由一个单独的BarDataSet表示。在显式（库处理）组的情况下，条目的实际x位置无关紧要。基于条目列表中BarEntry的位置执行分组。

float groupSpace = 0.06f;float barSpace = 0.02f; // x2 datasetfloat barWidth = 0.45f; // x2 dataset// (0.02 + 0.45) * 2 + 0.06 = 1.00 -> interval per "group"BarData data = new BarData(set1, set2);data.setBarWidth(barWidth); // set the width of each barbarChart.setData(data);barChart.groupBars(1980f, groupSpace, barSpace); // perform the "explicit" groupingbarChart.invalidate(); // refresh

在上面的代码片段中，BarDataSet对象被添加到一个BarChart。该groupBars(...)方法执行两个BarDataSet对象的分组。该方法采用以下参数：

public void groupBars(float fromX, float groupSpace, float barSpace) { ... }

fromX参数确定XAxis分组条的起始位置（在本例中为“1980”），groupSpace确定每组条之间留下的空间，barSpace确定组中各个条之间的间距。基于这些参数，该groupBars(...)方法改变每个条形XAxis朝向分组外观的位置，保持各个BarEntry对象的顺序。

每个组在XAxis上具有的“间隔”（占用空间）也由groupSpace和barSpace参数以及barWidth定义。

效果应该看起来像这样：

 

当然，也可以在不使用groupBars（...）方法的情况下实现BarChart的分组，只需手动将各个条正确放置在XAxis上即可。

为了确保XAxis的标签位于组上方，如上面的屏幕截图所示，您可以使用以下setCenterAxisLabels(...)方法：

XAxis xAxis = chart.getXAxis();xAxis.setCenterAxisLabels(true);

Stacked BarChart

堆叠的BarChart设置与普通的BarChart完全相似，但创建单个BarEntry对象的方式除外。如果是堆叠条形，则必须使用BarEntry的不同构造函数：

public BarEntry(float x, float [] yValues) { ... }

此构造函数允许提供多个yValues，表示每个条的“堆栈”的值。请考虑以下示例对象：

BarEntry stackedEntry = new BarEntry(0f, new float[] { 10, 20, 30 });

BarEntry由三个值组成，具有“高度”为“10”，“20”和“30”。

PieChart

与其他图表类型不同，PieChart以PieEntry对象的形式获取数据。这些对象的构造函数如下所示：

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

构造函数的第一个参数用于实际的“值”，该值应该作为PieChart中的饼图绘制。名为“label”的第二个String参数用于提供切片的其他描述。请考虑以下PieChart示例设置：

List
     
       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位置的值，因为图表中显示的PieEntry对象的顺序由它们在条目列表中的顺序确定。

添加一些额外的样式时，PieChart上面使用的数据结果可能类似于：