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相关的文档）