|
Header
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.jfree.chart.axis.Axis
org.jfree.chart.axis.ValueAxis
org.jfree.chart.axis.DateAxis
public class DateAxis
The base class for axes that display dates. You will find it easier to
understand how this axis works if you bear in mind that it really
displays/measures integer (or long) data, where the integers are
milliseconds since midnight, 1-Jan-1970. When displaying tick labels, the
millisecond values are converted back to dates using a
DateFormat
instance.
You can also create a Timeline
and supply in
the constructor to create an axis that only contains certain domain values.
For example, this allows you to create a date axis that only contains
working days.
Field Summary | |
---|---|
static java.util.Date |
DEFAULT_ANCHOR_DATE
The default anchor date. |
static double |
DEFAULT_AUTO_RANGE_MINIMUM_SIZE_IN_MILLISECONDS
The default minimum auto range size. |
static DateRange |
DEFAULT_DATE_RANGE
The default axis range. |
static DateTickUnit |
DEFAULT_DATE_TICK_UNIT
The default date tick unit. |
Fields inherited from class org.jfree.chart.axis.ValueAxis |
---|
DEFAULT_AUTO_RANGE, DEFAULT_AUTO_RANGE_MINIMUM_SIZE, DEFAULT_AUTO_TICK_UNIT_SELECTION, DEFAULT_INVERTED, DEFAULT_LOWER_BOUND, DEFAULT_LOWER_MARGIN, DEFAULT_RANGE, DEFAULT_UPPER_BOUND, DEFAULT_UPPER_MARGIN, MAXIMUM_TICK_COUNT |
Constructor Summary | |
---|---|
DateAxis()
Creates a date axis with no label. |
|
DateAxis(java.lang.String label)
Creates a date axis with the specified label. |
|
DateAxis(java.lang.String label,
java.util.TimeZone zone)
Deprecated. From 1.0.11 onwards, use DateAxis(String, TimeZone,
Locale) instead, to explicitly set the locale. |
|
DateAxis(java.lang.String label,
java.util.TimeZone zone,
java.util.Locale locale)
Creates a date axis. |
Method Summary | |
---|---|
protected void |
autoAdjustRange()
Rescales the axis to ensure that all data is visible. |
java.util.Date |
calculateHighestVisibleTickValue(DateTickUnit unit)
Calculates the value of the highest visible tick on the axis. |
java.util.Date |
calculateLowestVisibleTickValue(DateTickUnit unit)
Calculates the value of the lowest visible tick on the axis. |
java.lang.Object |
clone()
Returns a clone of the object. |
void |
configure()
Configures the axis to work with the specified plot. |
static TickUnitSource |
createStandardDateTickUnits()
Returns a collection of standard date tick units that uses the default time zone. |
static TickUnitSource |
createStandardDateTickUnits(java.util.TimeZone zone)
Deprecated. Since 1.0.11, use createStandardDateTickUnits(
TimeZone, Locale) to explicitly set the locale as well as the
time zone. |
static TickUnitSource |
createStandardDateTickUnits(java.util.TimeZone zone,
java.util.Locale locale)
Returns a collection of standard date tick units. |
double |
dateToJava2D(java.util.Date date,
java.awt.geom.Rectangle2D area,
org.jfree.ui.RectangleEdge edge)
Translates a date to Java2D coordinates, based on the range displayed by this axis for the specified data area. |
AxisState |
draw(java.awt.Graphics2D g2,
double cursor,
java.awt.geom.Rectangle2D plotArea,
java.awt.geom.Rectangle2D dataArea,
org.jfree.ui.RectangleEdge edge,
PlotRenderingInfo plotState)
Draws the axis on a Java 2D graphics device (such as the screen or a printer). |
boolean |
equals(java.lang.Object obj)
Tests this axis for equality with an arbitrary object. |
java.text.DateFormat |
getDateFormatOverride()
Returns the date format override. |
java.util.Date |
getMaximumDate()
Returns the latest date visible on the axis. |
java.util.Date |
getMinimumDate()
Returns the earliest date visible on the axis. |
DateTickMarkPosition |
getTickMarkPosition()
Returns the tick mark position (start, middle or end of the time period). |
DateTickUnit |
getTickUnit()
Returns the tick unit for the axis. |
Timeline |
getTimeline()
Returns the underlying timeline used by this axis. |
java.util.TimeZone |
getTimeZone()
Returns the time zone for the axis. |
int |
hashCode()
Returns a hash code for this object. |
boolean |
isHiddenValue(long millis)
Returns true if the axis hides this value, and
false otherwise. |
double |
java2DToValue(double java2DValue,
java.awt.geom.Rectangle2D area,
org.jfree.ui.RectangleEdge edge)
Translates a Java2D coordinate into the corresponding data value. |
protected java.util.Date |
nextStandardDate(java.util.Date date,
DateTickUnit unit)
Returns the first "standard" date (based on the specified field and units). |
protected java.util.Date |
previousStandardDate(java.util.Date date,
DateTickUnit unit)
Returns the previous "standard" date, for a given date and tick unit. |
java.util.List |
refreshTicks(java.awt.Graphics2D g2,
AxisState state,
java.awt.geom.Rectangle2D dataArea,
org.jfree.ui.RectangleEdge edge)
Calculates the positions of the tick labels for the axis, storing the results in the tick label list (ready for drawing). |
protected java.util.List |
refreshTicksHorizontal(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
org.jfree.ui.RectangleEdge edge)
Recalculates the ticks for the date axis. |
protected java.util.List |
refreshTicksVertical(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
org.jfree.ui.RectangleEdge edge)
Recalculates the ticks for the date axis. |
protected void |
selectAutoTickUnit(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
org.jfree.ui.RectangleEdge edge)
Selects an appropriate tick value for the axis. |
protected void |
selectHorizontalAutoTickUnit(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
org.jfree.ui.RectangleEdge edge)
Selects an appropriate tick size for the axis. |
protected void |
selectVerticalAutoTickUnit(java.awt.Graphics2D g2,
java.awt.geom.Rectangle2D dataArea,
org.jfree.ui.RectangleEdge edge)
Selects an appropriate tick size for the axis. |
void |
setDateFormatOverride(java.text.DateFormat formatter)
Sets the date format override. |
void |
setMaximumDate(java.util.Date maximumDate)
Sets the maximum date visible on the axis and sends an AxisChangeEvent to all registered listeners. |
void |
setMinimumDate(java.util.Date date)
Sets the minimum date visible on the axis and sends an AxisChangeEvent to all registered listeners. |
void |
setRange(java.util.Date lower,
java.util.Date upper)
Sets the axis range and sends an AxisChangeEvent to all
registered listeners. |
void |
setRange(double lower,
double upper)
Sets the axis range and sends an AxisChangeEvent to all
registered listeners. |
void |
setRange(Range range)
Sets the upper and lower bounds for the axis and sends an AxisChangeEvent to all registered listeners. |
void |
setRange(Range range,
boolean turnOffAutoRange,
boolean notify)
Sets the range for the axis, if requested, sends an AxisChangeEvent to all registered listeners. |
void |
setTickMarkPosition(DateTickMarkPosition position)
Sets the tick mark position (start, middle or end of the time period) and sends an AxisChangeEvent to all registered listeners. |
void |
setTickUnit(DateTickUnit unit)
Sets the tick unit for the axis. |
void |
setTickUnit(DateTickUnit unit,
boolean notify,
boolean turnOffAutoSelection)
Sets the tick unit attribute. |
void |
setTimeline(Timeline timeline)
Sets the underlying timeline to use for this axis. |
void |
setTimeZone(java.util.TimeZone zone)
Sets the time zone for the axis and sends an AxisChangeEvent to
all registered listeners. |
double |
valueToJava2D(double value,
java.awt.geom.Rectangle2D area,
org.jfree.ui.RectangleEdge edge)
Translates the data value to the display coordinates (Java 2D User Space) of the chart. |
void |
zoomRange(double lowerPercent,
double upperPercent)
Zooms in on the current range. |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final DateRange DEFAULT_DATE_RANGE
public static final double DEFAULT_AUTO_RANGE_MINIMUM_SIZE_IN_MILLISECONDS
public static final DateTickUnit DEFAULT_DATE_TICK_UNIT
public static final java.util.Date DEFAULT_ANCHOR_DATE
Constructor Detail |
---|
public DateAxis()
public DateAxis(java.lang.String label)
label
- the axis label (null
permitted).public DateAxis(java.lang.String label, java.util.TimeZone zone)
DateAxis(String, TimeZone,
Locale)
instead, to explicitly set the locale.
label
- the axis label (null
permitted).zone
- the time zone.SegmentedTimeline
public DateAxis(java.lang.String label, java.util.TimeZone zone, java.util.Locale locale)
label
- the axis label (null
permitted).zone
- the time zone.locale
- the locale (null
not permitted).SegmentedTimeline
Method Detail |
---|
public java.util.TimeZone getTimeZone()
null
).setTimeZone(TimeZone)
public void setTimeZone(java.util.TimeZone zone)
AxisChangeEvent
to
all registered listeners.
zone
- the time zone (null
not permitted).getTimeZone()
public Timeline getTimeline()
public void setTimeline(Timeline timeline)
If the timeline is changed, an AxisChangeEvent
is sent to all
registered listeners.
timeline
- the timeline.public DateTickUnit getTickUnit()
Note: if the autoTickUnitSelection
flag is
true
the tick unit may be changed while the axis is being
drawn, so in that case the return value from this method may be
irrelevant if the method is called before the axis has been drawn.
null
).setTickUnit(DateTickUnit)
,
ValueAxis.isAutoTickUnitSelection()
public void setTickUnit(DateTickUnit unit)
false
, and registered listeners are notified that
the axis has been changed.
unit
- the tick unit.getTickUnit()
,
setTickUnit(DateTickUnit, boolean, boolean)
public void setTickUnit(DateTickUnit unit, boolean notify, boolean turnOffAutoSelection)
unit
- the new tick unit.notify
- notify registered listeners?turnOffAutoSelection
- turn off auto selection?getTickUnit()
public java.text.DateFormat getDateFormatOverride()
null
).public void setDateFormatOverride(java.text.DateFormat formatter)
formatter
- the date formatter (null
permitted).public void setRange(Range range)
AxisChangeEvent
to all registered listeners. As a side-effect,
the auto-range flag is set to false.
setRange
in class ValueAxis
range
- the new range (null
not permitted).ValueAxis.getRange()
public void setRange(Range range, boolean turnOffAutoRange, boolean notify)
AxisChangeEvent
to all registered listeners. As a side-effect,
the auto-range flag is set to false
(optional).
setRange
in class ValueAxis
range
- the range (null
not permitted).turnOffAutoRange
- a flag that controls whether or not the auto
range is turned off.notify
- a flag that controls whether or not listeners are
notified.ValueAxis.getRange()
public void setRange(java.util.Date lower, java.util.Date upper)
AxisChangeEvent
to all
registered listeners.
lower
- the lower bound for the axis.upper
- the upper bound for the axis.public void setRange(double lower, double upper)
AxisChangeEvent
to all
registered listeners.
setRange
in class ValueAxis
lower
- the lower bound for the axis.upper
- the upper bound for the axis.ValueAxis.getRange()
,
ValueAxis.setRange(Range)
public java.util.Date getMinimumDate()
setMinimumDate(Date)
,
getMaximumDate()
public void setMinimumDate(java.util.Date date)
AxisChangeEvent
to all registered listeners. If
date
is on or after the current maximum date for
the axis, the maximum date will be shifted to preserve the current
length of the axis.
date
- the date (null
not permitted).getMinimumDate()
,
setMaximumDate(Date)
public java.util.Date getMaximumDate()
setMaximumDate(Date)
,
getMinimumDate()
public void setMaximumDate(java.util.Date maximumDate)
AxisChangeEvent
to all registered listeners. If
maximumDate
is on or before the current minimum date for
the axis, the minimum date will be shifted to preserve the current
length of the axis.
maximumDate
- the date (null
not permitted).getMinimumDate()
,
setMinimumDate(Date)
public DateTickMarkPosition getTickMarkPosition()
null
).public void setTickMarkPosition(DateTickMarkPosition position)
AxisChangeEvent
to all registered listeners.
position
- the position (null
not permitted).public void configure()
configure
in class Axis
public boolean isHiddenValue(long millis)
true
if the axis hides this value, and
false
otherwise.
millis
- the data value.
public double valueToJava2D(double value, java.awt.geom.Rectangle2D area, org.jfree.ui.RectangleEdge edge)
valueToJava2D
in class ValueAxis
value
- the date to be plotted.area
- the rectangle (in Java2D space) where the data is to be
plotted.edge
- the axis location.
ValueAxis.java2DToValue(double, Rectangle2D, RectangleEdge)
public double dateToJava2D(java.util.Date date, java.awt.geom.Rectangle2D area, org.jfree.ui.RectangleEdge edge)
date
- the date.area
- the rectangle (in Java2D space) where the data is to be
plotted.edge
- the axis location.
public double java2DToValue(double java2DValue, java.awt.geom.Rectangle2D area, org.jfree.ui.RectangleEdge edge)
java2DToValue
in class ValueAxis
java2DValue
- the coordinate in Java2D space.area
- the rectangle (in Java2D space) where the data is to be
plotted.edge
- the axis location.
ValueAxis.valueToJava2D(double, Rectangle2D, RectangleEdge)
public java.util.Date calculateLowestVisibleTickValue(DateTickUnit unit)
unit
- date unit to use.
public java.util.Date calculateHighestVisibleTickValue(DateTickUnit unit)
unit
- date unit to use.
protected java.util.Date previousStandardDate(java.util.Date date, DateTickUnit unit)
date
- the reference date.unit
- the tick unit.
protected java.util.Date nextStandardDate(java.util.Date date, DateTickUnit unit)
date
- the reference date.unit
- the date tick unit.
public static TickUnitSource createStandardDateTickUnits()
ValueAxis.setStandardTickUnits(TickUnitSource)
method inherited
from the ValueAxis
class).
public static TickUnitSource createStandardDateTickUnits(java.util.TimeZone zone)
createStandardDateTickUnits(
TimeZone, Locale)
to explicitly set the locale as well as the
time zone.
ValueAxis.setStandardTickUnits(TickUnitSource)
method inherited
from the ValueAxis
class).
zone
- the time zone (null
not permitted).
public static TickUnitSource createStandardDateTickUnits(java.util.TimeZone zone, java.util.Locale locale)
ValueAxis.setStandardTickUnits(TickUnitSource)
method inherited
from the ValueAxis
class).
zone
- the time zone (null
not permitted).locale
- the locale (null
not permitted).
protected void autoAdjustRange()
autoAdjustRange
in class ValueAxis
protected void selectAutoTickUnit(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, org.jfree.ui.RectangleEdge edge)
g2
- the graphics device.dataArea
- the area defined by the axes.edge
- the axis location.protected void selectHorizontalAutoTickUnit(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, org.jfree.ui.RectangleEdge edge)
g2
- the graphics device.dataArea
- the area defined by the axes.edge
- the axis location.protected void selectVerticalAutoTickUnit(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, org.jfree.ui.RectangleEdge edge)
g2
- the graphics device.dataArea
- the area in which the plot should be drawn.edge
- the axis location.public java.util.List refreshTicks(java.awt.Graphics2D g2, AxisState state, java.awt.geom.Rectangle2D dataArea, org.jfree.ui.RectangleEdge edge)
refreshTicks
in class Axis
g2
- the graphics device.state
- the axis state.dataArea
- the area in which the plot should be drawn.edge
- the location of the axis.
protected java.util.List refreshTicksHorizontal(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, org.jfree.ui.RectangleEdge edge)
g2
- the graphics device.dataArea
- the area in which the data is to be drawn.edge
- the location of the axis.
protected java.util.List refreshTicksVertical(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D dataArea, org.jfree.ui.RectangleEdge edge)
g2
- the graphics device.dataArea
- the area in which the plot should be drawn.edge
- the location of the axis.
public AxisState draw(java.awt.Graphics2D g2, double cursor, java.awt.geom.Rectangle2D plotArea, java.awt.geom.Rectangle2D dataArea, org.jfree.ui.RectangleEdge edge, PlotRenderingInfo plotState)
draw
in class Axis
g2
- the graphics device (null
not permitted).cursor
- the cursor location.plotArea
- the area within which the axes and data should be
drawn (null
not permitted).dataArea
- the area within which the data should be drawn
(null
not permitted).edge
- the location of the axis (null
not permitted).plotState
- collects information about the plot
(null
permitted).
null
).public void zoomRange(double lowerPercent, double upperPercent)
zoomRange
in class ValueAxis
lowerPercent
- the new lower bound.upperPercent
- the new upper bound.public boolean equals(java.lang.Object obj)
equals
in class ValueAxis
obj
- the object (null
permitted).
public int hashCode()
hashCode
in class java.lang.Object
public java.lang.Object clone() throws java.lang.CloneNotSupportedException
clone
in interface org.jfree.util.PublicCloneable
clone
in class ValueAxis
java.lang.CloneNotSupportedException
- if some component of the axis does
not support cloning.
|
Footer
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |