org.jfree.chart.plot
Class CombinedDomainCategoryPlot

java.lang.Object
  extended byorg.jfree.chart.plot.Plot
      extended byorg.jfree.chart.plot.CategoryPlot
          extended byorg.jfree.chart.plot.CombinedDomainCategoryPlot
All Implemented Interfaces:
AxisChangeListener, java.lang.Cloneable, DatasetChangeListener, java.util.EventListener, PlotChangeListener, org.jfree.util.PublicCloneable, RendererChangeListener, java.io.Serializable, ValueAxisPlot

public class CombinedDomainCategoryPlot
extends CategoryPlot
implements java.lang.Cloneable, org.jfree.util.PublicCloneable, java.io.Serializable, PlotChangeListener

A combined category plot where the domain axis is shared.

See Also:
Serialized Form

Field Summary
 
Fields inherited from class org.jfree.chart.plot.CategoryPlot
DEFAULT_DOMAIN_GRIDLINES_VISIBLE, DEFAULT_GRIDLINE_PAINT, DEFAULT_GRIDLINE_STROKE, DEFAULT_RANGE_GRIDLINES_VISIBLE, DEFAULT_VALUE_LABEL_FONT, localizationResources
 
Fields inherited from class org.jfree.chart.plot.Plot
DEFAULT_BACKGROUND_ALPHA, DEFAULT_BACKGROUND_PAINT, DEFAULT_FOREGROUND_ALPHA, DEFAULT_INSETS, DEFAULT_OUTLINE_PAINT, DEFAULT_OUTLINE_STROKE, MINIMUM_HEIGHT_TO_DRAW, MINIMUM_WIDTH_TO_DRAW, ZERO
 
Constructor Summary
CombinedDomainCategoryPlot()
          Default constructor.
CombinedDomainCategoryPlot(CategoryAxis domainAxis)
          Creates a new plot.
 
Method Summary
 void add(CategoryPlot subplot)
          Adds a subplot to the combined chart and sends a PlotChangeEvent to all registered listeners.
 void add(CategoryPlot subplot, int weight)
          Adds a subplot to the combined chart and sends a PlotChangeEvent to all registered listeners.
protected  AxisSpace calculateAxisSpace(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D plotArea)
          Calculates the space required for the axes.
 java.lang.Object clone()
          Returns a clone of the plot.
 void draw(java.awt.Graphics2D g2, java.awt.geom.Rectangle2D plotArea, PlotState parentState, PlotRenderingInfo info)
          Draws the plot on a Java 2D graphics device (such as the screen or a printer).
 boolean equals(java.lang.Object object)
          Tests the plot for equality with an arbitrary object.
 java.util.List getCategories()
          Returns an unmodifiable list of the categories contained in all the subplots.
 double getGap()
          Returns the space between subplots.
 LegendItemCollection getLegendItems()
          Returns a collection of legend items for the plot.
 java.util.List getSubplots()
          Returns the list of subplots.
 void handleClick(int x, int y, PlotRenderingInfo info)
          Handles a 'click' on the plot.
 void plotChanged(PlotChangeEvent event)
          Receives a PlotChangeEvent and responds by notifying all listeners.
 void remove(CategoryPlot subplot)
          Removes a subplot from the combined chart.
protected  void setFixedRangeAxisSpaceForSubplots(AxisSpace space)
          Sets the size (width or height, depending on the orientation of the plot) for the range axis of each subplot.
 void setGap(double gap)
          Sets the amount of space between subplots and sends a PlotChangeEvent to all registered listeners.
 void setOrientation(PlotOrientation orientation)
          Sets the orientation of the plot (and all subplots).
 
Methods inherited from class org.jfree.chart.plot.CategoryPlot
addAnnotation, addRangeMarker, addRangeMarker, addRangeMarker, calculateDomainAxisSpace, calculateRangeAxisSpace, clearDomainAxes, clearRangeAxes, clearRangeMarkers, clearRangeMarkers, configureDomainAxes, configureRangeAxes, datasetChanged, drawAnnotations, drawAxes, drawDomainGridlines, drawRangeGridlines, drawRangeLine, drawRangeMarkers, drawRangeMarkers, getAnchorValue, getAnnotations, getAxisOffset, getColumnRenderingOrder, getDataRange, getDataset, getDataset, getDatasetRenderingOrder, getDomainAxis, getDomainAxis, getDomainAxisEdge, getDomainAxisEdge, getDomainAxisForDataset, getDomainAxisLocation, getDomainAxisLocation, getDomainGridlinePaint, getDomainGridlinePosition, getDomainGridlineStroke, getDrawSharedDomainAxis, getFixedDomainAxisSpace, getFixedLegendItems, getFixedRangeAxisSpace, getOrientation, getPlotType, getRangeAxis, getRangeAxis, getRangeAxisEdge, getRangeAxisEdge, getRangeAxisForDataset, getRangeAxisLocation, getRangeAxisLocation, getRangeCrosshairPaint, getRangeCrosshairStroke, getRangeCrosshairValue, getRangeGridlinePaint, getRangeGridlineStroke, getRangeMarkers, getRangeMarkers, getRenderer, getRenderer, getRendererForDataset, getRowRenderingOrder, getWeight, isDomainGridlinesVisible, isRangeCrosshairLockedOnData, isRangeCrosshairVisible, isRangeGridlinesVisible, mapDatasetToDomainAxis, mapDatasetToRangeAxis, render, rendererChanged, setAnchorValue, setAnchorValue, setAxisOffset, setColumnRenderingOrder, setDataset, setDataset, setDatasetRenderingOrder, setDomainAxis, setDomainAxis, setDomainAxisLocation, setDomainAxisLocation, setDomainAxisLocation, setDomainGridlinePaint, setDomainGridlinePosition, setDomainGridlineStroke, setDomainGridlinesVisible, setDrawSharedDomainAxis, setFixedDomainAxisSpace, setFixedLegendItems, setFixedRangeAxisSpace, setRangeAxis, setRangeAxis, setRangeAxisLocation, setRangeAxisLocation, setRangeAxisLocation, setRangeAxisLocation, setRangeCrosshairLockedOnData, setRangeCrosshairPaint, setRangeCrosshairStroke, setRangeCrosshairValue, setRangeCrosshairValue, setRangeCrosshairVisible, setRangeGridlinePaint, setRangeGridlineStroke, setRangeGridlinesVisible, setRenderer, setRenderer, setRenderer, setRenderer, setRowRenderingOrder, setWeight, zoom, zoomHorizontalAxes, zoomHorizontalAxes, zoomVerticalAxes, zoomVerticalAxes
 
Methods inherited from class org.jfree.chart.plot.Plot
addChangeListener, axisChanged, draw, drawBackground, drawBackgroundImage, drawNoDataMessage, drawOutline, fillBackground, getBackgroundAlpha, getBackgroundImage, getBackgroundImageAlignment, getBackgroundPaint, getDataAreaRatio, getDatasetGroup, getDrawingSupplier, getForegroundAlpha, getInsets, getNoDataMessage, getNoDataMessageFont, getNoDataMessagePaint, getOutlinePaint, getOutlineStroke, getParent, getRectX, getRectY, getRootPlot, isSubplot, notifyListeners, removeChangeListener, resolveDomainAxisLocation, resolveRangeAxisLocation, setBackgroundAlpha, setBackgroundImage, setBackgroundImageAlignment, setBackgroundPaint, setDataAreaRatio, setDatasetGroup, setDrawingSupplier, setForegroundAlpha, setInsets, setInsets, setNoDataMessage, setNoDataMessageFont, setNoDataMessagePaint, setOutlinePaint, setOutlineStroke, setParent
 
Methods inherited from class java.lang.Object
finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

CombinedDomainCategoryPlot

public CombinedDomainCategoryPlot()
Default constructor.


CombinedDomainCategoryPlot

public CombinedDomainCategoryPlot(CategoryAxis domainAxis)
Creates a new plot.

Parameters:
domainAxis - the shared domain axis (null not permitted).
Method Detail

getGap

public double getGap()
Returns the space between subplots.

Returns:
The gap (in Java2D units).

setGap

public void setGap(double gap)
Sets the amount of space between subplots and sends a PlotChangeEvent to all registered listeners.

Parameters:
gap - the gap between subplots (in Java2D units).

add

public void add(CategoryPlot subplot)
Adds a subplot to the combined chart and sends a PlotChangeEvent to all registered listeners.

Parameters:
subplot - the subplot (null not permitted).

add

public void add(CategoryPlot subplot,
                int weight)
Adds a subplot to the combined chart and sends a PlotChangeEvent to all registered listeners.

Parameters:
subplot - the subplot (null not permitted).
weight - the weight (must be >= 1).

remove

public void remove(CategoryPlot subplot)
Removes a subplot from the combined chart. Potentially, this removes some unique categories from the overall union of the datasets...so the domain axis is reconfigured, then a PlotChangeEvent is sent to all registered listeners.

Parameters:
subplot - the subplot (null not permitted).

getSubplots

public java.util.List getSubplots()
Returns the list of subplots.

Returns:
An unmodifiable list of subplots .

calculateAxisSpace

protected AxisSpace calculateAxisSpace(java.awt.Graphics2D g2,
                                       java.awt.geom.Rectangle2D plotArea)
Calculates the space required for the axes.

Overrides:
calculateAxisSpace in class CategoryPlot
Parameters:
g2 - the graphics device.
plotArea - the plot area.
Returns:
The space required for the axes.

draw

public void draw(java.awt.Graphics2D g2,
                 java.awt.geom.Rectangle2D plotArea,
                 PlotState parentState,
                 PlotRenderingInfo info)
Draws the plot on a Java 2D graphics device (such as the screen or a printer). Will perform all the placement calculations for each sub-plots and then tell these to draw themselves.

Overrides:
draw in class CategoryPlot
Parameters:
g2 - the graphics device.
plotArea - the area within which the plot (including axis labels) should be drawn.
parentState - the state from the parent plot, if there is one.
info - collects information about the drawing (null permitted).

setFixedRangeAxisSpaceForSubplots

protected void setFixedRangeAxisSpaceForSubplots(AxisSpace space)
Sets the size (width or height, depending on the orientation of the plot) for the range axis of each subplot.

Parameters:
space - the space (null permitted).

setOrientation

public void setOrientation(PlotOrientation orientation)
Sets the orientation of the plot (and all subplots).

Overrides:
setOrientation in class CategoryPlot
Parameters:
orientation - the orientation (null not permitted).

getLegendItems

public LegendItemCollection getLegendItems()
Returns a collection of legend items for the plot.

Overrides:
getLegendItems in class CategoryPlot
Returns:
The legend items.

getCategories

public java.util.List getCategories()
Returns an unmodifiable list of the categories contained in all the subplots.

Overrides:
getCategories in class CategoryPlot
Returns:
The list.

handleClick

public void handleClick(int x,
                        int y,
                        PlotRenderingInfo info)
Handles a 'click' on the plot.

Overrides:
handleClick in class CategoryPlot
Parameters:
x - x-coordinate of the click.
y - y-coordinate of the click.
info - information about the plot's dimensions.

plotChanged

public void plotChanged(PlotChangeEvent event)
Receives a PlotChangeEvent and responds by notifying all listeners.

Specified by:
plotChanged in interface PlotChangeListener
Parameters:
event - the event.

equals

public boolean equals(java.lang.Object object)
Tests the plot for equality with an arbitrary object.

Overrides:
equals in class CategoryPlot
Parameters:
object - the object to test against.
Returns:
true or false.

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException
Returns a clone of the plot.

Specified by:
clone in interface org.jfree.util.PublicCloneable
Overrides:
clone in class CategoryPlot
Returns:
A clone.
Throws:
java.lang.CloneNotSupportedException - this class will not throw this exception, but subclasses (if any) might.