public abstract class

AbstractCategoryItemRenderer

extends AbstractRenderer
implements Serializable Cloneable CategoryItemRenderer
java.lang.Object
   ↳ org.jfree.chart.renderer.AbstractRenderer
     ↳ org.jfree.chart.renderer.category.AbstractCategoryItemRenderer
Known Direct Subclasses
Known Indirect Subclasses

Class Overview

An abstract base class that you can use to implement a new CategoryItemRenderer. When you create a new CategoryItemRenderer you are not required to extend this class, but it makes the job easier.

Summary

[Expand]
Inherited Fields
From class org.jfree.chart.renderer.AbstractRenderer
Protected Constructors
AbstractCategoryItemRenderer()
Creates a new renderer with no tool tip generator and no URL generator.
Public Methods
Object clone()
Returns an independent copy of the renderer.
void drawBackground(Graphics2D g2, CategoryPlot plot, Rectangle2D dataArea)
Draws a background for the data area.
void drawDomainGridline(Graphics2D g2, CategoryPlot plot, Rectangle2D dataArea, double value)
Draws a grid line against the domain axis.
void drawDomainMarker(Graphics2D g2, CategoryPlot plot, CategoryAxis axis, CategoryMarker marker, Rectangle2D dataArea)
Draws a marker for the domain axis.
void drawOutline(Graphics2D g2, CategoryPlot plot, Rectangle2D dataArea)
Draws an outline for the data area.
void drawRangeGridline(Graphics2D g2, CategoryPlot plot, ValueAxis axis, Rectangle2D dataArea, double value)
Draws a grid line against the range axis.
void drawRangeLine(Graphics2D g2, CategoryPlot plot, ValueAxis axis, Rectangle2D dataArea, double value, Paint paint, Stroke stroke)
Draws a line perpendicular to the range axis.
void drawRangeMarker(Graphics2D g2, CategoryPlot plot, ValueAxis axis, Marker marker, Rectangle2D dataArea)
Draws a marker for the range axis.
boolean equals(Object obj)
Tests this renderer for equality with another object.
Range findRangeBounds(CategoryDataset dataset)
Returns the range of values the renderer requires to display all the items from the specified dataset.
CategoryItemLabelGenerator getBaseItemLabelGenerator()
Returns the base item label generator.
CategoryURLGenerator getBaseItemURLGenerator()
Returns the base item URL generator.
CategoryToolTipGenerator getBaseToolTipGenerator()
Returns the base tool tip generator (the "layer 2" generator).
int getColumnCount()
Returns the number of columns in the dataset.
DrawingSupplier getDrawingSupplier()
Returns the drawing supplier from the plot.
CategoryItemLabelGenerator getItemLabelGenerator(int row, int column)
Returns the item label generator for a data item.
double getItemMiddle(Comparable rowKey, Comparable columnKey, CategoryDataset dataset, CategoryAxis axis, Rectangle2D area, RectangleEdge edge)
Returns the Java2D coordinate for the middle of the specified data item.
CategoryURLGenerator getItemURLGenerator(int row, int column)
Returns the URL generator for a data item.
LegendItem getLegendItem(int datasetIndex, int series)
Returns a legend item for a series.
CategorySeriesLabelGenerator getLegendItemLabelGenerator()
Returns the legend item label generator.
CategorySeriesLabelGenerator getLegendItemToolTipGenerator()
Returns the legend item tool tip generator.
CategorySeriesLabelGenerator getLegendItemURLGenerator()
Returns the legend item URL generator.
LegendItemCollection getLegendItems()
Returns a (possibly empty) collection of legend items for the series that this renderer is responsible for drawing.
int getPassCount()
Returns the number of passes through the dataset required by the renderer.
CategoryPlot getPlot()
Returns the plot that the renderer has been assigned to (where null indicates that the renderer is not currently assigned to a plot).
int getRowCount()
Returns the number of rows in the dataset.
CategoryItemLabelGenerator getSeriesItemLabelGenerator(int series)
Returns the item label generator for a series.
CategoryURLGenerator getSeriesItemURLGenerator(int series)
Returns the URL generator for a series.
CategoryToolTipGenerator getSeriesToolTipGenerator(int series)
Returns the tool tip generator for the specified series (a "layer 1" generator).
CategoryToolTipGenerator getToolTipGenerator()
This method is deprecated. This method should no longer be used (as of version 1.0.6). It is sufficient to rely on getSeriesToolTipGenerator(int) and getBaseToolTipGenerator().
CategoryToolTipGenerator getToolTipGenerator(int row, int column)
Returns the tool tip generator that should be used for the specified item.
int hashCode()
Returns a hash code for the renderer.
CategoryItemRendererState initialise(Graphics2D g2, Rectangle2D dataArea, CategoryPlot plot, int rendererIndex, PlotRenderingInfo info)
Initialises the renderer and returns a state object that will be used for the remainder of the drawing process for a single chart.
void setBaseItemLabelGenerator(CategoryItemLabelGenerator generator)
Sets the base item label generator and sends a RendererChangeEvent to all registered listeners.
void setBaseItemURLGenerator(CategoryURLGenerator generator)
Sets the base item URL generator and sends a RendererChangeEvent to all registered listeners.
void setBaseToolTipGenerator(CategoryToolTipGenerator generator)
Sets the base tool tip generator and sends a RendererChangeEvent to all registered listeners.
void setItemLabelGenerator(CategoryItemLabelGenerator generator)
This method is deprecated. This method should no longer be used (as of version 1.0.6). It is sufficient to rely on setSeriesItemLabelGenerator(int, CategoryItemLabelGenerator) and setBaseItemLabelGenerator(CategoryItemLabelGenerator).
void setItemURLGenerator(CategoryURLGenerator generator)
This method is deprecated. This method should no longer be used (as of version 1.0.6). It is sufficient to rely on setSeriesItemURLGenerator(int, CategoryURLGenerator) and setBaseItemURLGenerator(CategoryURLGenerator).
void setLegendItemLabelGenerator(CategorySeriesLabelGenerator generator)
Sets the legend item label generator and sends a RendererChangeEvent to all registered listeners.
void setLegendItemToolTipGenerator(CategorySeriesLabelGenerator generator)
Sets the legend item tool tip generator and sends a RendererChangeEvent to all registered listeners.
void setLegendItemURLGenerator(CategorySeriesLabelGenerator generator)
Sets the legend item URL generator and sends a RendererChangeEvent to all registered listeners.
void setPlot(CategoryPlot plot)
Sets the plot that the renderer has been assigned to.
void setSeriesItemLabelGenerator(int series, CategoryItemLabelGenerator generator)
Sets the item label generator for a series and sends a RendererChangeEvent to all registered listeners.
void setSeriesItemURLGenerator(int series, CategoryURLGenerator generator)
Sets the URL generator for a series and sends a RendererChangeEvent to all registered listeners.
void setSeriesToolTipGenerator(int series, CategoryToolTipGenerator generator)
Sets the tool tip generator for a series and sends a RendererChangeEvent to all registered listeners.
void setToolTipGenerator(CategoryToolTipGenerator generator)
This method is deprecated. This method should no longer be used (as of version 1.0.6). It is sufficient to rely on setSeriesToolTipGenerator(int, CategoryToolTipGenerator) and setBaseToolTipGenerator(CategoryToolTipGenerator).
Protected Methods
void addEntity(EntityCollection entities, Shape hotspot, CategoryDataset dataset, int row, int column, double entityX, double entityY)
Adds an entity to the collection.
void addItemEntity(EntityCollection entities, CategoryDataset dataset, int row, int column, Shape hotspot)
Adds an entity with the specified hotspot.
Point2D calculateDomainMarkerTextAnchorPoint(Graphics2D g2, PlotOrientation orientation, Rectangle2D dataArea, Rectangle2D markerArea, RectangleInsets markerOffset, LengthAdjustmentType labelOffsetType, RectangleAnchor anchor)
Calculates the (x, y) coordinates for drawing the label for a marker on the range axis.
Point2D calculateRangeMarkerTextAnchorPoint(Graphics2D g2, PlotOrientation orientation, Rectangle2D dataArea, Rectangle2D markerArea, RectangleInsets markerOffset, LengthAdjustmentType labelOffsetType, RectangleAnchor anchor)
Calculates the (x, y) coordinates for drawing a marker label.
CategoryItemRendererState createState(PlotRenderingInfo info)
Creates a new state instance---this method is called from the initialise(Graphics2D, Rectangle2D, CategoryPlot, int, PlotRenderingInfo) method.
void drawItemLabel(Graphics2D g2, PlotOrientation orientation, CategoryDataset dataset, int row, int column, double x, double y, boolean negative)
Draws an item label.
Range findRangeBounds(CategoryDataset dataset, boolean includeInterval)
Returns the range of values the renderer requires to display all the items from the specified dataset.
CategoryAxis getDomainAxis(CategoryPlot plot, int index)
Returns a domain axis for a plot.
ValueAxis getRangeAxis(CategoryPlot plot, int index)
Returns a range axis for a plot.
void updateCrosshairValues(CategoryCrosshairState crosshairState, Comparable rowKey, Comparable columnKey, double value, int datasetIndex, double transX, double transY, PlotOrientation orientation)
Considers the current (x, y) coordinate and updates the crosshair point if it meets the criteria (usually means the (x, y) coordinate is the closest to the anchor point so far).
[Expand]
Inherited Methods
From class org.jfree.chart.renderer.AbstractRenderer
From class java.lang.Object
From interface org.jfree.chart.LegendItemSource
From interface org.jfree.chart.renderer.category.CategoryItemRenderer

Protected Constructors

protected AbstractCategoryItemRenderer ()

Creates a new renderer with no tool tip generator and no URL generator. The defaults (no tool tip or URL generators) have been chosen to minimise the processing required to generate a default chart. If you require tool tips or URLs, then you can easily add the required generators.

Public Methods

public Object clone ()

Returns an independent copy of the renderer. The plot reference is shallow copied.

Returns
  • A clone.
Throws
CloneNotSupportedException can be thrown if one of the objects belonging to the renderer does not support cloning (for example, an item label generator).

public void drawBackground (Graphics2D g2, CategoryPlot plot, Rectangle2D dataArea)

Draws a background for the data area. The default implementation just gets the plot to draw the background, but some renderers will override this behaviour.

Parameters
g2 the graphics device.
plot the plot.
dataArea the data area.

public void drawDomainGridline (Graphics2D g2, CategoryPlot plot, Rectangle2D dataArea, double value)

Draws a grid line against the domain axis.

Note that this default implementation assumes that the horizontal axis is the domain axis. If this is not the case, you will need to override this method.

Parameters
g2 the graphics device.
plot the plot.
dataArea the area for plotting data (not yet adjusted for any 3D effect).
value the Java2D value at which the grid line should be drawn.

public void drawDomainMarker (Graphics2D g2, CategoryPlot plot, CategoryAxis axis, CategoryMarker marker, Rectangle2D dataArea)

Draws a marker for the domain axis.

Parameters
g2 the graphics device (not null).
plot the plot (not null).
axis the range axis (not null).
marker the marker to be drawn (not null).
dataArea the area inside the axes (not null).

public void drawOutline (Graphics2D g2, CategoryPlot plot, Rectangle2D dataArea)

Draws an outline for the data area. The default implementation just gets the plot to draw the outline, but some renderers will override this behaviour.

Parameters
g2 the graphics device.
plot the plot.
dataArea the data area.

public void drawRangeGridline (Graphics2D g2, CategoryPlot plot, ValueAxis axis, Rectangle2D dataArea, double value)

Draws a grid line against the range axis.

Parameters
g2 the graphics device.
plot the plot.
axis the value axis.
dataArea the area for plotting data (not yet adjusted for any 3D effect).
value the value at which the grid line should be drawn.

public void drawRangeLine (Graphics2D g2, CategoryPlot plot, ValueAxis axis, Rectangle2D dataArea, double value, Paint paint, Stroke stroke)

Draws a line perpendicular to the range axis.

Parameters
g2 the graphics device.
plot the plot.
axis the value axis.
dataArea the area for plotting data (not yet adjusted for any 3D effect).
value the value at which the grid line should be drawn.
paint the paint (null not permitted).
stroke the stroke (null not permitted).

public void drawRangeMarker (Graphics2D g2, CategoryPlot plot, ValueAxis axis, Marker marker, Rectangle2D dataArea)

Draws a marker for the range axis.

Parameters
g2 the graphics device (not null).
plot the plot (not null).
axis the range axis (not null).
marker the marker to be drawn (not null).
dataArea the area inside the axes (not null).

public boolean equals (Object obj)

Tests this renderer for equality with another object.

Parameters
obj the object.
Returns
  • true or false.

public Range findRangeBounds (CategoryDataset dataset)

Returns the range of values the renderer requires to display all the items from the specified dataset.

Parameters
dataset the dataset (null permitted).
Returns
  • The range (or null if the dataset is null or empty).

public CategoryItemLabelGenerator getBaseItemLabelGenerator ()

Returns the base item label generator.

Returns
  • The generator (possibly null).

public CategoryURLGenerator getBaseItemURLGenerator ()

Returns the base item URL generator.

Returns
  • The item URL generator.

public CategoryToolTipGenerator getBaseToolTipGenerator ()

Returns the base tool tip generator (the "layer 2" generator).

Returns
  • The tool tip generator (possibly null).

public int getColumnCount ()

Returns the number of columns in the dataset. This value is updated in the initialise(Graphics2D, Rectangle2D, CategoryPlot, int, PlotRenderingInfo) method.

Returns
  • The column count.

public DrawingSupplier getDrawingSupplier ()

Returns the drawing supplier from the plot.

Returns
  • The drawing supplier (possibly null).

public CategoryItemLabelGenerator getItemLabelGenerator (int row, int column)

Returns the item label generator for a data item. This implementation simply passes control to the getSeriesItemLabelGenerator(int) method. If, for some reason, you want a different generator for individual items, you can override this method.

Parameters
row the row index (zero based).
column the column index (zero based).
Returns
  • The generator (possibly null).

public double getItemMiddle (Comparable rowKey, Comparable columnKey, CategoryDataset dataset, CategoryAxis axis, Rectangle2D area, RectangleEdge edge)

Returns the Java2D coordinate for the middle of the specified data item.

Parameters
rowKey the row key.
columnKey the column key.
dataset the dataset.
axis the axis.
area the data area.
edge the edge along which the axis lies.
Returns
  • The Java2D coordinate for the middle of the item.

public CategoryURLGenerator getItemURLGenerator (int row, int column)

Returns the URL generator for a data item. This method just calls the getSeriesItemURLGenerator method, but you can override this behaviour if you want to.

Parameters
row the row index (zero based).
column the column index (zero based).
Returns
  • The URL generator.

public LegendItem getLegendItem (int datasetIndex, int series)

Returns a legend item for a series. This default implementation will return null if isSeriesVisible(int) or isSeriesVisibleInLegend(int) returns false.

Parameters
datasetIndex the dataset index (zero-based).
series the series index (zero-based).
Returns
  • The legend item (possibly null).
See Also

public CategorySeriesLabelGenerator getLegendItemLabelGenerator ()

Returns the legend item label generator.

Returns
  • The label generator (never null).

public CategorySeriesLabelGenerator getLegendItemToolTipGenerator ()

Returns the legend item tool tip generator.

Returns
  • The tool tip generator (possibly null).

public CategorySeriesLabelGenerator getLegendItemURLGenerator ()

Returns the legend item URL generator.

Returns
  • The URL generator (possibly null).

public LegendItemCollection getLegendItems ()

Returns a (possibly empty) collection of legend items for the series that this renderer is responsible for drawing.

Returns
  • The legend item collection (never null).

public int getPassCount ()

Returns the number of passes through the dataset required by the renderer. This method returns 1, subclasses should override if they need more passes.

Returns
  • The pass count.

public CategoryPlot getPlot ()

Returns the plot that the renderer has been assigned to (where null indicates that the renderer is not currently assigned to a plot).

Returns
  • The plot (possibly null).

public int getRowCount ()

Returns the number of rows in the dataset. This value is updated in the initialise(Graphics2D, Rectangle2D, CategoryPlot, int, PlotRenderingInfo) method.

Returns
  • The row count.

public CategoryItemLabelGenerator getSeriesItemLabelGenerator (int series)

Returns the item label generator for a series.

Parameters
series the series index (zero based).
Returns
  • The generator (possibly null).

public CategoryURLGenerator getSeriesItemURLGenerator (int series)

Returns the URL generator for a series.

Parameters
series the series index (zero based).
Returns
  • The URL generator for the series.

public CategoryToolTipGenerator getSeriesToolTipGenerator (int series)

Returns the tool tip generator for the specified series (a "layer 1" generator).

Parameters
series the series index (zero-based).
Returns
  • The tool tip generator (possibly null).

public CategoryToolTipGenerator getToolTipGenerator ()

This method is deprecated.
This method should no longer be used (as of version 1.0.6). It is sufficient to rely on getSeriesToolTipGenerator(int) and getBaseToolTipGenerator().

Returns the tool tip generator that will be used for ALL items in the dataset (the "layer 0" generator).

Returns
  • A tool tip generator (possibly null).

public CategoryToolTipGenerator getToolTipGenerator (int row, int column)

Returns the tool tip generator that should be used for the specified item. This method looks up the generator using the "three-layer" approach outlined in the general description of this interface. You can override this method if you want to return a different generator per item.

Parameters
row the row index (zero-based).
column the column index (zero-based).
Returns
  • The generator (possibly null).

public int hashCode ()

Returns a hash code for the renderer.

Returns
  • The hash code.

public CategoryItemRendererState initialise (Graphics2D g2, Rectangle2D dataArea, CategoryPlot plot, int rendererIndex, PlotRenderingInfo info)

Initialises the renderer and returns a state object that will be used for the remainder of the drawing process for a single chart. The state object allows for the fact that the renderer may be used simultaneously by multiple threads (each thread will work with a separate state object).

Parameters
g2 the graphics device.
dataArea the data area.
plot the plot.
rendererIndex the renderer index.
info an object for returning information about the structure of the plot (null permitted).
Returns
  • The renderer state.

public void setBaseItemLabelGenerator (CategoryItemLabelGenerator generator)

Sets the base item label generator and sends a RendererChangeEvent to all registered listeners.

Parameters
generator the generator (null permitted).

public void setBaseItemURLGenerator (CategoryURLGenerator generator)

Sets the base item URL generator and sends a RendererChangeEvent to all registered listeners.

Parameters
generator the item URL generator (null permitted).

public void setBaseToolTipGenerator (CategoryToolTipGenerator generator)

Sets the base tool tip generator and sends a RendererChangeEvent to all registered listeners.

Parameters
generator the generator (null permitted).

public void setItemLabelGenerator (CategoryItemLabelGenerator generator)

This method is deprecated.
This method should no longer be used (as of version 1.0.6). It is sufficient to rely on setSeriesItemLabelGenerator(int, CategoryItemLabelGenerator) and setBaseItemLabelGenerator(CategoryItemLabelGenerator).

Sets the item label generator for ALL series and sends a RendererChangeEvent to all registered listeners.

Parameters
generator the generator (null permitted).

public void setItemURLGenerator (CategoryURLGenerator generator)

This method is deprecated.
This method should no longer be used (as of version 1.0.6). It is sufficient to rely on setSeriesItemURLGenerator(int, CategoryURLGenerator) and setBaseItemURLGenerator(CategoryURLGenerator).

Sets the item URL generator for ALL series and sends a RendererChangeEvent to all registered listeners.

Parameters
generator the generator.

public void setLegendItemLabelGenerator (CategorySeriesLabelGenerator generator)

Sets the legend item label generator and sends a RendererChangeEvent to all registered listeners.

Parameters
generator the generator (null not permitted).

public void setLegendItemToolTipGenerator (CategorySeriesLabelGenerator generator)

Sets the legend item tool tip generator and sends a RendererChangeEvent to all registered listeners.

Parameters
generator the generator (null permitted).

public void setLegendItemURLGenerator (CategorySeriesLabelGenerator generator)

Sets the legend item URL generator and sends a RendererChangeEvent to all registered listeners.

Parameters
generator the generator (null permitted).

public void setPlot (CategoryPlot plot)

Sets the plot that the renderer has been assigned to. This method is usually called by the CategoryPlot, in normal usage you shouldn't need to call this method directly.

Parameters
plot the plot (null not permitted).
See Also

public void setSeriesItemLabelGenerator (int series, CategoryItemLabelGenerator generator)

Sets the item label generator for a series and sends a RendererChangeEvent to all registered listeners.

Parameters
series the series index (zero based).
generator the generator (null permitted).

public void setSeriesItemURLGenerator (int series, CategoryURLGenerator generator)

Sets the URL generator for a series and sends a RendererChangeEvent to all registered listeners.

Parameters
series the series index (zero based).
generator the generator.

public void setSeriesToolTipGenerator (int series, CategoryToolTipGenerator generator)

Sets the tool tip generator for a series and sends a RendererChangeEvent to all registered listeners.

Parameters
series the series index (zero-based).
generator the generator (null permitted).

public void setToolTipGenerator (CategoryToolTipGenerator generator)

This method is deprecated.
This method should no longer be used (as of version 1.0.6). It is sufficient to rely on setSeriesToolTipGenerator(int, CategoryToolTipGenerator) and setBaseToolTipGenerator(CategoryToolTipGenerator).

Sets the tool tip generator for ALL series and sends a RendererChangeEvent to all registered listeners.

Parameters
generator the generator (null permitted).

Protected Methods

protected void addEntity (EntityCollection entities, Shape hotspot, CategoryDataset dataset, int row, int column, double entityX, double entityY)

Adds an entity to the collection.

Parameters
entities the entity collection being populated.
hotspot the entity area (if null a default will be used).
dataset the dataset.
row the series.
column the item.
entityX the entity's center x-coordinate in user space (only used if area is null).
entityY the entity's center y-coordinate in user space (only used if area is null).

protected void addItemEntity (EntityCollection entities, CategoryDataset dataset, int row, int column, Shape hotspot)

Adds an entity with the specified hotspot.

Parameters
entities the entity collection.
dataset the dataset.
row the row index.
column the column index.
hotspot the hotspot (null not permitted).

protected Point2D calculateDomainMarkerTextAnchorPoint (Graphics2D g2, PlotOrientation orientation, Rectangle2D dataArea, Rectangle2D markerArea, RectangleInsets markerOffset, LengthAdjustmentType labelOffsetType, RectangleAnchor anchor)

Calculates the (x, y) coordinates for drawing the label for a marker on the range axis.

Parameters
g2 the graphics device.
orientation the plot orientation.
dataArea the data area.
markerArea the rectangle surrounding the marker.
markerOffset the marker offset.
labelOffsetType the label offset type.
anchor the label anchor.
Returns
  • The coordinates for drawing the marker label.

protected Point2D calculateRangeMarkerTextAnchorPoint (Graphics2D g2, PlotOrientation orientation, Rectangle2D dataArea, Rectangle2D markerArea, RectangleInsets markerOffset, LengthAdjustmentType labelOffsetType, RectangleAnchor anchor)

Calculates the (x, y) coordinates for drawing a marker label.

Parameters
g2 the graphics device.
orientation the plot orientation.
dataArea the data area.
markerArea the rectangle surrounding the marker.
markerOffset the marker offset.
labelOffsetType the label offset type.
anchor the label anchor.
Returns
  • The coordinates for drawing the marker label.

protected CategoryItemRendererState createState (PlotRenderingInfo info)

Creates a new state instance---this method is called from the initialise(Graphics2D, Rectangle2D, CategoryPlot, int, PlotRenderingInfo) method. Subclasses can override this method if they need to use a subclass of CategoryItemRendererState.

Parameters
info collects plot rendering info (null permitted).
Returns
  • The new state instance (never null).

protected void drawItemLabel (Graphics2D g2, PlotOrientation orientation, CategoryDataset dataset, int row, int column, double x, double y, boolean negative)

Draws an item label.

Parameters
g2 the graphics device.
orientation the orientation.
dataset the dataset.
row the row.
column the column.
x the x coordinate (in Java2D space).
y the y coordinate (in Java2D space).
negative indicates a negative value (which affects the item label position).

protected Range findRangeBounds (CategoryDataset dataset, boolean includeInterval)

Returns the range of values the renderer requires to display all the items from the specified dataset.

Parameters
dataset the dataset (null permitted).
includeInterval include the y-interval if the dataset has one.
Returns
  • The range (null if the dataset is null or empty).

protected CategoryAxis getDomainAxis (CategoryPlot plot, int index)

Returns a domain axis for a plot.

Parameters
plot the plot.
index the axis index.
Returns
  • A domain axis.

protected ValueAxis getRangeAxis (CategoryPlot plot, int index)

Returns a range axis for a plot.

Parameters
plot the plot.
index the axis index.
Returns
  • A range axis.

protected void updateCrosshairValues (CategoryCrosshairState crosshairState, Comparable rowKey, Comparable columnKey, double value, int datasetIndex, double transX, double transY, PlotOrientation orientation)

Considers the current (x, y) coordinate and updates the crosshair point if it meets the criteria (usually means the (x, y) coordinate is the closest to the anchor point so far).

Parameters
crosshairState the crosshair state (null permitted, but the method does nothing in that case).
rowKey the row key.
columnKey the column key.
value the data value.
datasetIndex the dataset index.
transX the x-value translated to Java2D space.
transY the y-value translated to Java2D space.
orientation the plot orientation (null not permitted).