public interface IAxisLabelFormatter
extends java.io.Serializable
In order to get as much labels as possible on the Chart2D's axes, an Axis
should be configured in a way that reduces the return value of the method
getMaxAmountChars()
.
AAxis
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
PROPERTY_FORMATCHANGE
Constant for
fired
when the configuration changes. |
Modifier and Type | Method and Description |
---|---|
void |
addPropertyChangeListener(java.lang.String propertyName,
java.beans.PropertyChangeListener listener)
Registers a property change listener that will be informed about changes of
the property identified by the given
propertyName . |
java.lang.String |
format(double value)
Provide a String for the value.
|
int |
getMaxAmountChars()
Returns the maximum amount of characters that will be returned from
format(double) . |
double |
getMinimumValueShiftForChange()
Returns the minimum change in the value to format that will cause to return
a different formatted String.
|
double |
getNextEvenValue(double value,
boolean ceiling)
Returns the next "even" value to the given one.
|
AUnit |
getUnit()
Returns the unit that is currently used by this formatter.
|
void |
initPaintIteration()
|
java.lang.Number |
parse(java.lang.String formatted)
The reverse operation to
. |
void |
removePropertyChangeListener(java.lang.String property,
java.beans.PropertyChangeListener listener)
Deregisters a property change listener that has been registerd for
listening on the given property.
|
void |
setAxis(IAxis<?> axis)
Allows the
AAxis to register
itself with the given formatter so that it may get information about the
data (e.g. |
static final java.lang.String PROPERTY_FORMATCHANGE
PropertyChangeEvent
fired
when the configuration changes.void addPropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener)
propertyName
.
propertyName
- the name of the property the listener is interested inlistener
- a listener that will only be informed if the property identified
by the argument propertyName
changesjava.lang.String format(double value)
value
- the value to format.int getMaxAmountChars()
format(double)
.
format(double)
.double getMinimumValueShiftForChange()
To achieve two different formatted Strings to be returned from the format method the corresponding values given to the format method have to differ at least by this value.
Some implementations (e.g. a formatter for date) have to use their own
format method an increas a value to determine when the first change will
occur. This is expensive and it's recommended that this action is performed
once only and the result is stored. Additionally this routine has to start
with an "even" (see getNextEvenValue(double, boolean)
) value to
get a correct result (the distance from even number to even number).
double getNextEvenValue(double value, boolean ceiling)
value
- the value to get the next "even" value for.ceiling
- if true, the next higher number will returned, else the next lower
one.AUnit getUnit()
void initPaintIteration()
java.lang.Number parse(java.lang.String formatted) throws java.lang.NumberFormatException
format(double)
.
The given argument has to be in the format that will be generated by that
method or exceptions may be thrown.
test.parse(test.format(d))== d
has to be true if no rounding occurs by the formatter.
formatted
- a String
in the format that will be produced by
method format(double)
.java.lang.NumberFormatException
- if the format of the argument is invalid.void removePropertyChangeListener(java.lang.String property, java.beans.PropertyChangeListener listener)
listener
- a listener that will only be informed if the property identified
by the argument propertyName
changesproperty
- the property the listener was registered to.void setAxis(IAxis<?> axis)
AAxis
to register
itself with the given formatter so that it may get information about the
data (e.g. range) it has to format.
This method should only be invoked by
AAxis
, all other invocations will
cause trouble.
axis
- the axis to gain information about.Copyright © 2001 - 2010 LGPL, All Rights Footloose.