10.Formatting Axis Values (AxisV

2017-11-06 本文已影响59人 xiaobug

在v3.0.0中介绍,该接口允许在绘制前设置XAxis和YAxis的自定义格式

Creating a Formatter

实现轴上的值自定义格式化都需要创建一个类实现IAxisValueFormattera接口,如下所示.这个formatter用于将轴的值始终格式化为保留1位小数.

public class MyYAxisValueFormatter implements IAxisValueFormatter {

    private DecimalFormat mFormat;

    public MyAxisValueFormatter() {

        // format values to 1 decimal digit
        mFormat = new DecimalFormat("###,###,##0.0");
    }

    @Override
    public String getFormattedValue(float value, AxisBase axis) {
        // "value" represents the position of the label on the axis (x or y)
        return mFormat.format(value) + " $";
    }
    
    /** this is only needed if numbers are returned, else return 0 */
    @Override
    public int getDecimalDigits() { return 1; }
}

下面的例子展示了如何将String数组中的数值绘制到轴上:

public class MyXAxisValueFormatter implements IAxisValueFormatter {

    private String[] mValues;

    public MyXAxisValueFormatter(String[] values) {
        this.mValues = values;
    }

    @Override
    public String getFormattedValue(float value, AxisBase axis) {
        // "value" represents the position of the label on the axis (x or y)
        return mValues[(int) value];
    }
    
    /** this is only needed if numbers are returned, else return 0 */
    @Override
    public int getDecimalDigits() { return 0; }
}

Setting the Formatter

创建Formatter后,简单的将它设置给选择的轴上:

YAxis left = chart.getAxisLeft();
left.setValueFormatter(new MyYAxisValueFormatter());

String[] values = new String[] { ... };

XAxis xAxis = chart.getXAxis();
xAxis.setValueFormatter(new MyXAxisValueFormatter(values));

替换了从轴的最小值到最大值之间的默认值,轴将会显示经过格式化的特殊数据.

Restricting Intervals

如果你使用基于数组索引的formatter(像上面说的那个),设置最小间距为1是有意义的:

axis.setGranularity(1f); // restrict interval to 1 (minimum)

这将会防止绘制重复的标签(由于轴的间距<1).当缩放比例足够大的时候,将会停止计算最小间距

Predefined Formatters

LargeValueFormatter:用于格式化大于1,000的数值.将1,000转换为1k,1,000,000转换为1m(million),1,000,000,000转换为1b(billion),1 trillion转换为1t.
PercentFormatter:用于显示在一个十进制数后面增加"%"标记.尤其适用于PieChart. 50->50.0%
*StackedValueFormatter:专门用于重叠BarChart.它语序指定显示所有的重叠的数值,还是只显示最顶部的数值.

Example Formatters

DayAxisValueFormatter:这个Formatter可以将提供的数值转换为日期字符串,并根据缩放变换.

LegacyFormatters

发布v3.0.0之前,XAxis和YAxis有单独的formatter,文档可以在下载找到: