13.Legend(MPAndroidChart中文翻译)

第8节.Setting Colors(MPAndroidChart中文翻译)
第9节.Formatting Data Values (ValueFormatter)(MPAndroidChart中文翻译)
第10节-Formatting Axis Values (AxisValueFormatter)(MPAndroidChart中文翻译)
第11节.General Settings & Styling(MPAndroidChart中文翻译)
第12节.Specific Settings & Styling(MPAndroidChart中文翻译)
第13节.Legend(MPAndroidChart中文翻译)
第14节.Dynamic & Realtime Data(MPAndroidChart中文翻译)
第15节. Modifying the Viewport(MPAndroidChart中文翻译)
第16节.Animations(MPAndroidChart中文翻译)
第17节. MarkerView (Popup View)(MPAndroidChart中文翻译)
第18节. The ChartData class(MPAndroidChart中文翻译)
第19节. ChartData subclasses(MPAndroidChart中文翻译)
第20节. The DataSet class (general DataSet styling)(MPAndroidChart中文翻译)
第21节. DataSet subclasses (specific DataSet styling)(MPAndroidChart中文翻译)
第22节. The ViewPortHandler(MPAndroidChart中文翻译)
第23节. Customizing the Fill-Line-Position (FillFormatter)(MPAndroidChart中文翻译)
第24节. Proguard(MPAndroidChart中文翻译)
第25节. Realm.io mobile database(MPAndroidChart中文翻译)
第26节. Creating your own (custom) DataSets(MPAndroidChart中文翻译)
第27节. Miscellaneous (more useful stuff)(MPAndroidChart中文翻译)

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

自动生成的图例包含的条目数量取决于不同的颜色(通过所有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...