Package org.jfree.chart.title
Class PaintScaleLegend
- java.lang.Object
-
- org.jfree.chart.block.AbstractBlock
-
- org.jfree.chart.title.Title
-
- org.jfree.chart.title.PaintScaleLegend
-
- All Implemented Interfaces:
java.io.Serializable
,java.lang.Cloneable
,java.util.EventListener
,Block
,AxisChangeListener
,org.jfree.ui.Drawable
,org.jfree.util.PublicCloneable
public class PaintScaleLegend extends Title implements AxisChangeListener, org.jfree.util.PublicCloneable
A legend that shows a range of values and their associated colors, driven by an underlyingPaintScale
implementation.- Since:
- 1.0.4
- See Also:
- Serialized Form
-
-
Field Summary
-
Fields inherited from class org.jfree.chart.title.Title
DEFAULT_HORIZONTAL_ALIGNMENT, DEFAULT_PADDING, DEFAULT_POSITION, DEFAULT_VERTICAL_ALIGNMENT, visible
-
-
Constructor Summary
Constructors Constructor Description PaintScaleLegend(PaintScale scale, ValueAxis axis)
Creates a new instance.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description org.jfree.ui.Size2D
arrange(java.awt.Graphics2D g2, RectangleConstraint constraint)
Arranges the contents of the block, within the given constraints, and returns the block size.protected org.jfree.ui.Size2D
arrangeRR(java.awt.Graphics2D g2, Range widthRange, Range heightRange)
Returns the content size for the title.void
axisChanged(AxisChangeEvent event)
Receives notification of an axis change event and responds by firing a title change event.void
draw(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D area)
Draws the legend within the specified area.java.lang.Object
draw(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D area, java.lang.Object params)
Draws the legend within the specified area.boolean
equals(java.lang.Object obj)
Tests this legend for equality with an arbitrary object.ValueAxis
getAxis()
Returns the axis for the paint scale.AxisLocation
getAxisLocation()
Returns the axis location.double
getAxisOffset()
Returns the offset between the axis and the paint strip.java.awt.Paint
getBackgroundPaint()
Returns the background paint.PaintScale
getScale()
Returns the scale used to convert values to colors.java.awt.Paint
getStripOutlinePaint()
Returns the paint used to draw the outline of the paint strip.java.awt.Stroke
getStripOutlineStroke()
Returns the stroke used to draw the outline around the paint strip.double
getStripWidth()
Returns the width of the paint strip, in Java2D units.int
getSubdivisionCount()
Returns the number of subdivisions used to draw the scale.boolean
isStripOutlineVisible()
Returns the flag that controls whether or not an outline is drawn around the paint strip.void
setAxis(ValueAxis axis)
Sets the axis for the paint scale and sends aTitleChangeEvent
to all registered listeners.void
setAxisLocation(AxisLocation location)
Sets the axis location and sends aTitleChangeEvent
to all registered listeners.void
setAxisOffset(double offset)
Sets the offset between the axis and the paint strip and sends aTitleChangeEvent
to all registered listeners.void
setBackgroundPaint(java.awt.Paint paint)
Sets the background paint and sends aTitleChangeEvent
to all registered listeners.void
setScale(PaintScale scale)
Sets the scale and sends aTitleChangeEvent
to all registered listeners.void
setStripOutlinePaint(java.awt.Paint paint)
Sets the paint used to draw the outline of the paint strip, and sends aTitleChangeEvent
to all registered listeners.void
setStripOutlineStroke(java.awt.Stroke stroke)
Sets the stroke used to draw the outline around the paint strip and sends aTitleChangeEvent
to all registered listeners.void
setStripOutlineVisible(boolean visible)
Sets the flag that controls whether or not an outline is drawn around the paint strip, and sends aTitleChangeEvent
to all registered listeners.void
setStripWidth(double width)
Sets the width of the paint strip and sends aTitleChangeEvent
to all registered listeners.void
setSubdivisionCount(int count)
Sets the subdivision count and sends aTitleChangeEvent
to all registered listeners.-
Methods inherited from class org.jfree.chart.title.Title
addChangeListener, clone, getHorizontalAlignment, getNotify, getPosition, getVerticalAlignment, hashCode, isVisible, notifyListeners, removeChangeListener, setHorizontalAlignment, setNotify, setPosition, setVerticalAlignment, setVisible
-
Methods inherited from class org.jfree.chart.block.AbstractBlock
arrange, calculateTotalHeight, calculateTotalWidth, drawBorder, getBorder, getBounds, getContentXOffset, getContentYOffset, getFrame, getHeight, getID, getMargin, getPadding, getWidth, setBorder, setBorder, setBounds, setFrame, setHeight, setID, setMargin, setMargin, setPadding, setPadding, setWidth, toContentConstraint, trimBorder, trimMargin, trimPadding, trimToContentHeight, trimToContentWidth
-
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, toString, wait, wait, wait
-
-
-
-
Constructor Detail
-
PaintScaleLegend
public PaintScaleLegend(PaintScale scale, ValueAxis axis)
Creates a new instance.- Parameters:
scale
- the scale (null
not permitted).axis
- the axis (null
not permitted).
-
-
Method Detail
-
getScale
public PaintScale getScale()
Returns the scale used to convert values to colors.- Returns:
- The scale (never
null
). - See Also:
setScale(PaintScale)
-
setScale
public void setScale(PaintScale scale)
Sets the scale and sends aTitleChangeEvent
to all registered listeners.- Parameters:
scale
- the scale (null
not permitted).- See Also:
getScale()
-
getAxis
public ValueAxis getAxis()
Returns the axis for the paint scale.- Returns:
- The axis (never
null
). - See Also:
setAxis(ValueAxis)
-
setAxis
public void setAxis(ValueAxis axis)
Sets the axis for the paint scale and sends aTitleChangeEvent
to all registered listeners.- Parameters:
axis
- the axis (null
not permitted).- See Also:
getAxis()
-
getAxisLocation
public AxisLocation getAxisLocation()
Returns the axis location.- Returns:
- The axis location (never
null
). - See Also:
setAxisLocation(AxisLocation)
-
setAxisLocation
public void setAxisLocation(AxisLocation location)
Sets the axis location and sends aTitleChangeEvent
to all registered listeners.- Parameters:
location
- the location (null
not permitted).- See Also:
getAxisLocation()
-
getAxisOffset
public double getAxisOffset()
Returns the offset between the axis and the paint strip.- Returns:
- The offset between the axis and the paint strip.
- See Also:
setAxisOffset(double)
-
setAxisOffset
public void setAxisOffset(double offset)
Sets the offset between the axis and the paint strip and sends aTitleChangeEvent
to all registered listeners.- Parameters:
offset
- the offset.
-
getStripWidth
public double getStripWidth()
Returns the width of the paint strip, in Java2D units.- Returns:
- The width of the paint strip.
- See Also:
setStripWidth(double)
-
setStripWidth
public void setStripWidth(double width)
Sets the width of the paint strip and sends aTitleChangeEvent
to all registered listeners.- Parameters:
width
- the width.- See Also:
getStripWidth()
-
isStripOutlineVisible
public boolean isStripOutlineVisible()
Returns the flag that controls whether or not an outline is drawn around the paint strip.- Returns:
- A boolean.
- See Also:
setStripOutlineVisible(boolean)
-
setStripOutlineVisible
public void setStripOutlineVisible(boolean visible)
Sets the flag that controls whether or not an outline is drawn around the paint strip, and sends aTitleChangeEvent
to all registered listeners.- Parameters:
visible
- the flag.- See Also:
isStripOutlineVisible()
-
getStripOutlinePaint
public java.awt.Paint getStripOutlinePaint()
Returns the paint used to draw the outline of the paint strip.- Returns:
- The paint (never
null
). - See Also:
setStripOutlinePaint(Paint)
-
setStripOutlinePaint
public void setStripOutlinePaint(java.awt.Paint paint)
Sets the paint used to draw the outline of the paint strip, and sends aTitleChangeEvent
to all registered listeners.- Parameters:
paint
- the paint (null
not permitted).- See Also:
getStripOutlinePaint()
-
getStripOutlineStroke
public java.awt.Stroke getStripOutlineStroke()
Returns the stroke used to draw the outline around the paint strip.- Returns:
- The stroke (never
null
). - See Also:
setStripOutlineStroke(Stroke)
-
setStripOutlineStroke
public void setStripOutlineStroke(java.awt.Stroke stroke)
Sets the stroke used to draw the outline around the paint strip and sends aTitleChangeEvent
to all registered listeners.- Parameters:
stroke
- the stroke (null
not permitted).- See Also:
getStripOutlineStroke()
-
getBackgroundPaint
public java.awt.Paint getBackgroundPaint()
Returns the background paint.- Returns:
- The background paint.
-
setBackgroundPaint
public void setBackgroundPaint(java.awt.Paint paint)
Sets the background paint and sends aTitleChangeEvent
to all registered listeners.- Parameters:
paint
- the paint (null
permitted).
-
getSubdivisionCount
public int getSubdivisionCount()
Returns the number of subdivisions used to draw the scale.- Returns:
- The subdivision count.
- Since:
- 1.0.11
-
setSubdivisionCount
public void setSubdivisionCount(int count)
Sets the subdivision count and sends aTitleChangeEvent
to all registered listeners.- Parameters:
count
- the count.- Since:
- 1.0.11
-
axisChanged
public void axisChanged(AxisChangeEvent event)
Receives notification of an axis change event and responds by firing a title change event.- Specified by:
axisChanged
in interfaceAxisChangeListener
- Parameters:
event
- the event.- Since:
- 1.0.13
-
arrange
public org.jfree.ui.Size2D arrange(java.awt.Graphics2D g2, RectangleConstraint constraint)
Arranges the contents of the block, within the given constraints, and returns the block size.- Specified by:
arrange
in interfaceBlock
- Overrides:
arrange
in classAbstractBlock
- Parameters:
g2
- the graphics device.constraint
- the constraint (null
not permitted).- Returns:
- The block size (in Java2D units, never
null
).
-
arrangeRR
protected org.jfree.ui.Size2D arrangeRR(java.awt.Graphics2D g2, Range widthRange, Range heightRange)
Returns the content size for the title. This will reflect the fact that a text title positioned on the left or right of a chart will be rotated 90 degrees.- Parameters:
g2
- the graphics device.widthRange
- the width range.heightRange
- the height range.- Returns:
- The content size.
-
draw
public void draw(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D area)
Draws the legend within the specified area.
-
draw
public java.lang.Object draw(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D area, java.lang.Object params)
Draws the legend within the specified area.
-
-