13.Legend(MPAndroidChart中文翻译)

2017-11-07 本文已影响78人 xiaobug

默认情况下,所有类型的图表都支持图例,并在设置数据后自动为图表生成并绘制图例.图例通常由多个条目组成,每个条目由一个标签和一个表格/形状组成.

自动生成的图例包含的条目数量取决于不同的颜色(通过所有DataSet对象)和DataSet的标签数.图例中的标签取决于图表中DataSet对象设置的标签.如果没有为DataSet对象指定标签,图表将自动生成他们.如果一个DataSet对象使用了很多颜色,这些颜色是一个组并且仅用一个标签类描述.

为了自定义图例,你可以用getLegend()方法获取图例对象:

Legend legend = chart.getLegend();

Control if the legend should be drawn(控制图例是否显示)

setEnabled(boolean enabled):设置图例是否显示,如果禁用,图例将不会绘制.

Styling / modifying the legend(图例的样式和模式)

setTextColor(int color):设置图例标签的颜色.
setTextSize(float size):设置图例标签的字体大小,单位dp.
setTypeface(Typeface tf): 给图例标签设置自定义字体.

Wrapping / clipping avoidance(包裹内容/避免裁剪)

setWordWrapEnabled(boolean enabled):如果启用,图例内容将不会超出图表的边框,而是创建新的一行.注意,这会降低性能,并且仅用于图表下方的图例.
setMaxSizePercent(float maxSize): 用百分比形式设置相对于整个图表的最大尺寸.默认值为0.95f(95%)

Customizing the legend(自定义图例)

setPosition(LegendPosition pos):设置图例的位置,它表示图例出现的位置. 在他们之中选择:

RIGHT_OF_CHART, 
RIGHT_OF_CHART_CENTER, 
RIGHT_OF_CHART_INSIDE, 
BELOW_CHART_LEFT, 
BELOW_CHART_RIGHT, 
BELOW_CHART_CENTER or 
PIECHART_CENTER (PieChart only), 
... 等.

setForm(LegendForm shape): 设置图例表单形状,这个形状使用DataSet中设置的图例颜色,被绘制在图例标签旁边.从他们之中选择:

SQUARE, 
CIRCLE or 
LINE.

setFormSize(float size): 设置图例表单大小,单位dp.
setXEntrySpace(float space):设置x轴方向图例条目之间的距离.
setYEntrySpace(float space):设置y轴方向图例条目之间的距离.
setFormToTextSpace(float space):设置图例标签和相应的表单之间的空隙.
setWordWrapEnabled(boolean enabled):是否设置包裹图例内容?/目前仅支持BelowChartLeft, BelowChartRight, BelowChartCenter./为了设置文本换行的位置,设置当文本换行时的最大尺寸百分比.

Setting custom labels & colors(设置自定义便签和颜色)

setCustom(int[] colors, String[] labels):设置自定义图例的标签和颜色数组.颜色的数量应该和便签的数量一致.每个表单都会绘制相同索引处的颜色.空标签将会开启一个组.A(-2)颜色将避免绘制表单,这将会禁用从dataSets中自动计算图例标签和颜色功能.调用resetCustom()方法重新开启自动计算功能(需要调用notifyDataSetChanged()方法来自动计算图例)
resetCustom(): 调用他将禁止自定义图例标签(有setCustom()方法设置的).
setExtra(int[] colors, String[] labels): 设置额外的颜色和标签,将会在图例自动计算完毕后添加到颜色和标签集合末尾.(如果图例已经计算完毕,你需要调用notifyDataSetChanged()方法来使更改生效)

Example(举个栗子)

   Legend l = chart.getLegend();
   l.setFormSize(10f); // set the size of the legend forms/shapes
   l.setForm(LegendForm.CIRCLE); // set what type of form/shape should be used
   l.setPosition(LegendPosition.BELOW_CHART_LEFT);
   l.setTypeface(...);
   l.setTextSize(12f);
   l.setTextColor(Color.BLACK);
   l.setXEntrySpace(5f); // set the space between the legend entries on the x-axis
   l.setYEntrySpace(5f); // set the space between the legend entries on the y-axis

   // set custom labels and colors
   l.setCustom(ColorTemplate.VORDIPLOM_COLORS, new String[] { "Set1", "Set2", "Set3", "Set4", "Set5" });

   // and many more...