## 12.2 显示条目标签 ### 12.2.1 概述 条目标签默认是不显示的，因此我们需要使用renderer进行创建和显示条目标签。这主要有以下两个步骤： + 分配一个CategoryItemLabelGenerator或XYItemLabelGenerator给renderer—这是一个负责创建标签的对象。 + 在renderer里面设置一个标签可视的标志。可以针对全部系列进行设置，也可以针对具体的每一个系列进行设置。 此外，我们可以定制条目标签的位置、字体和颜色。在下面的章节里我们将详细的介绍。 ### 12.2.2 创建一个条目标签并赋值 使用renderer分配的一个标签产生器创建条目标签（这与图表工具条的机制是相同的）。 下面代码说了将一个标签产生器指派给CategoryItemRenderer： ``` CategoryItemRenderer renderer = categoryplot.getRenderer(); CategoryItemLabelGenerator generator = new StandardCategoryItemLabelGenerator("{2}", new DecimalFormat("0.00")); renderer.setBaseItemLabelGenerator(generator); ``` 同样的，将一个产生器指派给XYItemRenderer，代码如下： ``` XYPlot plot = (XYPlot) jfreechart.getPlot(); XYItemRenderer renderer = plot.getRenderer(); XYItemLabelGenerator generator = new StandardXYItemLabelGenerator( "{2}", new DecimalFormat("0.00"), new DecimalFormat("0.00")); renderer.setBaseItemLabelGenerator(generator); ``` 我们可以在标准产生器的构造函数中定制不同的行为。当然了，我们也可以创建我们总计的产生器，详见12.5.2章节。 ### 12.2.3 所有的系列显示条目标签 方法renderer.setBaseItemLabelsVisible(false)是控制着条目标签的显示。对于CategoryItemRenderer： ``` CategoryItemRenderer renderer = categoryplot.getRenderer(); renderer.setBaseItemLabelsVisible(true); ``` 同样对于：XYItemRenderer ``` XYItemRenderer renderer = categoryplot.getRenderer(); renderer.setBaseItemLabelsVisible(true); ``` 一旦设置，这个标志优先管理我们在所有地方对每一系列做的设置，主要为了应用每一系列的设置。我们可以设置个标志为null（见12.2.4章节） ### 12.2.4 为选择的系列显示条目标签 我们可以控制图表的每一个系列的条目标签是否显示。例如：如下图12.2仅显示第一系列条目标签。  如图12.2显示第一系列条目标签 下面代码可以设置如上效果： ``` CategoryItemRenderer renderer = categoryplot.getRenderer(); renderer.setBaseItemLabelGenerator(new StandardCategoryItemLabelGenerator()); renderer.setBaseItemLabelsVisible(null); // clears the ALL series flag renderer.setSeriesItemLabelsVisible(0, true); renderer.setSeriesItemLabelsVisible(1, false); ``` 注意：上面代码中对全部的系列设置为null—这一点非常重要，因为全部系列的标志控制每一个系列的标志。 ### 12.2.5 问题与解决 如果按照上面的步骤操作，你仍然未看见条目标签显示在图表上，那么我们从以下几个方面进行考虑： + Renderere必须需要一个标签产生器——这是一个用来创建每一个标签的文本条目的对象。 + 一些renderer不支持条目标签（具体参考renderer相关的文档）