Package org.jfree.chart.labels
Class StandardPieSectionLabelGenerator
java.lang.Object
org.jfree.chart.labels.AbstractPieItemLabelGenerator
org.jfree.chart.labels.StandardPieSectionLabelGenerator
- All Implemented Interfaces:
Serializable
,Cloneable
,PieSectionLabelGenerator
,PublicCloneable
public class StandardPieSectionLabelGenerator extends AbstractPieItemLabelGenerator implements PieSectionLabelGenerator, Cloneable, PublicCloneable, Serializable
A standard item label generator for plots that use data from a
PieDataset
.
For the label format, use {0} where the pie section key should be inserted,
{1} for the absolute section value and {2} for the percent amount of the pie
section, e.g. "{0} = {1} ({2})"
will display as
apple = 120 (5%)
.
- See Also:
- Serialized Form
-
Field Summary
Fields Modifier and Type Field Description static String
DEFAULT_SECTION_LABEL_FORMAT
The default section label format. -
Constructor Summary
Constructors Constructor Description StandardPieSectionLabelGenerator()
Creates a new section label generator usingDEFAULT_SECTION_LABEL_FORMAT
as the label format string, and platform default number and percentage formatters.StandardPieSectionLabelGenerator(String labelFormat)
Creates a new section label generator using the specified label format string, and platform default number and percentage formatters.StandardPieSectionLabelGenerator(String labelFormat, NumberFormat numberFormat, NumberFormat percentFormat)
Creates an item label generator using the specified number formatters.StandardPieSectionLabelGenerator(String labelFormat, Locale locale)
Creates a new instance for the specified locale.StandardPieSectionLabelGenerator(Locale locale)
Creates a new instance for the specified locale. -
Method Summary
Modifier and Type Method Description Object
clone()
Returns an independent copy of the generator.boolean
equals(Object obj)
Tests the generator for equality with an arbitrary object.AttributedString
generateAttributedSectionLabel(PieDataset dataset, Comparable key)
Generates an attributed label for the specified series, ornull
if no attributed label is available (in which case, the string returned bygenerateSectionLabel(PieDataset, Comparable)
will provide the fallback).String
generateSectionLabel(PieDataset dataset, Comparable key)
Generates a label for a pie section.AttributedString
getAttributedLabel(int section)
Returns the attributed label for a section, ornull
if none is defined.void
setAttributedLabel(int section, AttributedString label)
Sets the attributed label for a section.Methods inherited from class org.jfree.chart.labels.AbstractPieItemLabelGenerator
createItemArray, getLabelFormat, getNumberFormat, getPercentFormat, hashCode
-
Field Details
-
DEFAULT_SECTION_LABEL_FORMAT
The default section label format.- See Also:
- Constant Field Values
-
-
Constructor Details
-
StandardPieSectionLabelGenerator
public StandardPieSectionLabelGenerator()Creates a new section label generator usingDEFAULT_SECTION_LABEL_FORMAT
as the label format string, and platform default number and percentage formatters. -
StandardPieSectionLabelGenerator
Creates a new instance for the specified locale.- Parameters:
locale
- the local (null
not permitted).
-
StandardPieSectionLabelGenerator
Creates a new section label generator using the specified label format string, and platform default number and percentage formatters.- Parameters:
labelFormat
- the label format (null
not permitted).
-
StandardPieSectionLabelGenerator
Creates a new instance for the specified locale.- Parameters:
labelFormat
- the label format (null
not permitted).locale
- the local (null
not permitted).
-
StandardPieSectionLabelGenerator
public StandardPieSectionLabelGenerator(String labelFormat, NumberFormat numberFormat, NumberFormat percentFormat)Creates an item label generator using the specified number formatters.- Parameters:
labelFormat
- the label format string (null
not permitted).numberFormat
- the format object for the values (null
not permitted).percentFormat
- the format object for the percentages (null
not permitted).
-
-
Method Details
-
getAttributedLabel
Returns the attributed label for a section, ornull
if none is defined.- Parameters:
section
- the section index.- Returns:
- The attributed label.
-
setAttributedLabel
Sets the attributed label for a section.- Parameters:
section
- the section index.label
- the label (null
permitted).
-
generateSectionLabel
Generates a label for a pie section.- Specified by:
generateSectionLabel
in interfacePieSectionLabelGenerator
- Overrides:
generateSectionLabel
in classAbstractPieItemLabelGenerator
- Parameters:
dataset
- the dataset (null
not permitted).key
- the section key (null
not permitted).- Returns:
- The label (possibly
null
).
-
generateAttributedSectionLabel
Generates an attributed label for the specified series, ornull
if no attributed label is available (in which case, the string returned bygenerateSectionLabel(PieDataset, Comparable)
will provide the fallback). Only certain attributes are recognised by the code that ultimately displays the labels:TextAttribute.FONT
: will set the font;TextAttribute.POSTURE
: a value ofTextAttribute.POSTURE_OBLIQUE
will addFont.ITALIC
to the current font;TextAttribute.WEIGHT
: a value ofTextAttribute.WEIGHT_BOLD
will addFont.BOLD
to the current font;TextAttribute.FOREGROUND
: this will set thePaint
for the currentTextAttribute.SUPERSCRIPT
: the valuesTextAttribute.SUPERSCRIPT_SUB
andTextAttribute.SUPERSCRIPT_SUPER
are recognised.
- Specified by:
generateAttributedSectionLabel
in interfacePieSectionLabelGenerator
- Parameters:
dataset
- the dataset (null
not permitted).key
- the key.- Returns:
- An attributed label (possibly
null
).
-
equals
Tests the generator for equality with an arbitrary object.- Overrides:
equals
in classAbstractPieItemLabelGenerator
- Parameters:
obj
- the object to test against (null
permitted).- Returns:
- A boolean.
-
clone
Returns an independent copy of the generator.- Specified by:
clone
in interfacePublicCloneable
- Overrides:
clone
in classAbstractPieItemLabelGenerator
- Returns:
- A clone.
- Throws:
CloneNotSupportedException
- should not happen.
-