public abstract class IlvCompositeChartRenderer extends IlvChartRenderer
AREA, BAR, BUBBLE, CANDLE, CENTERED_LABEL_LAYOUT, COMBO, DATA_LABEL, DEFAULT_LABEL_LAYOUT, DEFAULT_LABELING, HILO, HILO_ARROW, HILO_STICK, HLOC, OUTSIDE_LABEL_LAYOUT, PERCENT_LABEL, PIE, POLYLINE, SCATTER, STACKED_AREA, STACKED_BAR, STACKED_DIVERGING_BAR, STACKED_POLYLINE, STACKED_STAIR, STACKED100_AREA, STACKED100_BAR, STACKED100_POLYLINE, STACKED100_STAIR, STAIR, SUMMED_STAIR, SUPERIMPOSED_BAR, TREEMAP, X_VALUE_LABEL, XY_VALUES_LABEL, Y_VALUE_LABEL
Modifier | Constructor and Description |
---|---|
protected |
IlvCompositeChartRenderer()
Creates a new
IlvCompositeChartRenderer . |
Modifier and Type | Method and Description |
---|---|
void |
addImageMapAreas(IlvIMapDefinition mapDef,
List<? super IlvIMapArea> areaList)
Generates image map areas.
|
void |
collectDisplayItems(IlvChartDataPicker picker,
ArrayList<IlvDisplayPoint> accumulator)
Collects the display items containing the specified picking point.
|
protected abstract IlvChartRenderer |
createChild(IlvDataSet dataSet)
Creates a new child renderer to display the specified data set.
|
IlvLegendItem[] |
createLegendItems()
Creates the legend item instances associated to this renderer.
|
void |
draw(Graphics dst)
Draws the renderer using the specified
Graphics . |
void |
draw(Graphics dst,
IlvDataSet dataSet,
int iMin,
int iMax)
Deprecated.
This method is not used by JViews.
|
void |
drawAnnotations(Graphics dst)
Draws the annotations of the renderer using the
specified
Graphics . |
void |
drawIntoHitmap(IlvChartHitmapDefinition definition,
IlvChartHitmapAccumulator accumulator)
Draws the rendering into a hitmap.
|
void |
drawLegendSymbol(IlvLegendItem item,
Graphics g,
int x,
int y,
int w,
int h)
Draws the symbol of the given legend item.
|
void |
drawSelectionHandles(Graphics g,
IlvHandlesSelectionStyle style)
Draws this renderer with selection handles.
|
IlvDataAnnotation |
getAnnotation(IlvDataSet dataSet,
int idx)
Returns the annotation of the specified data point.
|
Rectangle2D |
getBounds(IlvDataSet dataSet,
int iMin,
int iMax,
Rectangle2D bounds,
boolean includeAnnotations)
Returns the bounds of the graphical representation for the
specified data.
|
Rectangle2D |
getBounds(Rectangle2D bounds,
boolean includeAnnotations)
Returns the bounds of the graphical representation for the
visible data.
|
IlvChartRenderer |
getChild(IlvDataSet dataSet)
Returns the child renderer that is used to display the specified data set.
|
IlvChartRenderer |
getChild(int idx)
Returns the child renderer at the specified index.
|
IlvChartRenderer |
getChild(String dataSetName)
Returns the child renderer that is used to display the data set with the
specified name.
|
int |
getChildCount()
Returns the number of child renderers.
|
Iterator<IlvChartRenderer> |
getChildIterator()
Returns an iterator over the children of this renderer.
|
List<IlvChartRenderer> |
getChildren()
Returns the children of this renderer.
|
IlvDisplayPoint |
getDisplayItem(IlvChartDataPicker picker)
Returns the display item containing the specified picking point.
|
IlvDisplayPoint |
getDisplayPoint(IlvDataSet dataSet,
int dataIdx)
Returns the display point corresponding to the specified data point.
|
String |
getLegendText(IlvLegendItem item)
Returns the label of the specified legend item.
|
IlvDisplayPoint |
getNearestItem(IlvChartDataPicker picker,
double[] distanceResult)
Returns the display item closest to the picking point defined
by the specified data picker.
|
IlvDisplayPoint |
getNearestPoint(IlvChartDataPicker picker)
Returns the display point closest to the picking point defined
by the specified data picker.
|
IlvDataRenderingHint |
getRenderingHint(IlvDataSet dataSet)
Returns the rendering hint that was specified globally for all the points
of the given data set.
|
IlvDataRenderingHint |
getRenderingHint(IlvDataSet dataSet,
int idx)
Returns the rendering hint of the specified data point.
|
IlvStyle |
getStyle(IlvDataSet dataSet,
int index)
Returns the style used to display the specified data point.
|
IlvStyle[] |
getStyles()
Returns all the styles used by the child renderers.
|
IlvDataInterval |
getXRange(IlvDataInterval retRange)
Returns the range of the x-values displayed by this renderer.
|
IlvDataInterval |
getYRange(IlvDataInterval retRange)
Returns the range of the y-values displayed by this renderer.
|
IlvDataInterval |
getYRange(IlvDataInterval xRange,
IlvDataInterval retRange)
Returns the range of the y-values displayed by this renderer within the
specified X interval.
|
boolean |
holdsAnnotations()
Returns true if some annotations are defined for some data sets,
data points, or data objects, in this renderer.
|
boolean |
isViewable()
Indicates whether this renderer can be displayed.
|
void |
setAnnotation(IlvDataSet dataSet,
IlvDataAnnotation annotation)
Specifies an annotation for all the data points of a data set.
|
void |
setAnnotation(IlvDataSet dataSet,
int idx,
IlvDataAnnotation annotation)
Specifies an annotation for a data point.
|
void |
setDataPoint(IlvDataSet dataSet,
int dataIndex,
double xData,
double yData)
Changes the value of a data point.
|
void |
setDisplayPoint(IlvDataSet dataSet,
int dataIndex,
double xCoord,
double yCoord)
Changes the value of a data point according to the specified projected
coordinates.
|
void |
setRenderingHint(IlvDataSet dataSet,
IlvDataRenderingHint hint)
Specifies a rendering hint for all the data points of a data set.
|
void |
setRenderingHint(IlvDataSet dataSet,
int idx,
IlvDataRenderingHint hint)
Specifies a rendering hint for a data point.
|
void |
setStyles(IlvStyle[] styles)
Sets the styles used by the child renderers.
|
protected void |
updateChildren()
Called when children have been added or removed from this renderer.
|
applyStyles, applyStyles, applyStyles, chartConnected, computeDataLabel, computeDataLabelLocation, create, createRenderer, dataSetsAdded, dataSetsChangesBatchEnding, dataSetsChangesBatchStarting, dataSetsRemoved, dispose, drawSelectionHandles, drawSelectionHandles, drawSelectionHandles, endRendererChanges, findAppropriateColor, fireTreemapFocusEvent, getAnnotation, getBounds, getChart, getClipRect, getCoordinateSystem, getDataLabeling, getDataLabelLayout, getDataLabelling, getDataSetIndex, getDataSetMainIndex, getDataSetMainRenderer, getDataSource, getDefaultColors, getDefaultLegendTitle, getDepths, getDisplayItem, getDisplayItems, getLegendStyle, getMinDataSetCount, getName, getNearestItem, getNearestPoint, getParent, getPlotRect, getPreferredMargins, getRenderingHint, getStyle, getVirtualDataSet, getXShift, getYAxisIdx, has3DSupport, isDisplayingDataSet, isVisible, isVisibleInLegend, reDraw, register, set3D, setAnnotation, setDataLabeling, setDataLabelLayout, setDataLabelling, setDataSource, setName, setParent, setRenderingHint, setRenderingHintWithNoDraw, setStyle, setVisible, setVisibleInLegend, setXShift, setYAxisIdx, startRendererChanges, toData, toDisplay, toDisplay, triggerChange
protected IlvCompositeChartRenderer()
IlvCompositeChartRenderer
.public boolean isViewable()
true
if the visible
property
is set to true
and if at least one of the child renderer can be viewed.isViewable
in interface IlvChartAreaAccessible
isViewable
in class IlvChartRenderer
IlvChartRenderer.isVisible()
public void setStyles(IlvStyle[] styles)
setStyles
in class IlvChartRenderer
public IlvStyle[] getStyles()
getStyles
in class IlvChartRenderer
public IlvStyle getStyle(IlvDataSet dataSet, int index)
getStyle
in class IlvChartRenderer
dataSet
- The considered data set.index
- The index of the considered data point.null
if
this data point is not displayed by the renderer.public int getChildCount()
getChildCount
in class IlvChartRenderer
public IlvChartRenderer getChild(int idx)
getChild
in class IlvChartRenderer
public List<IlvChartRenderer> getChildren()
getChildren
in class IlvChartRenderer
IlvChartRenderer
public Iterator<IlvChartRenderer> getChildIterator()
IlvChartRenderer
.
The returned iterator does not allow the element removal
(an UnsupportedOperationException
is thrown when
calling the remove
method).getChildIterator
in class IlvChartRenderer
IlvChartRenderer
elementspublic IlvChartRenderer getChild(IlvDataSet dataSet)
public final IlvChartRenderer getChild(String dataSetName)
getChild(IlvDataSet)
protected abstract IlvChartRenderer createChild(IlvDataSet dataSet)
dataSet
by the
caller.protected void updateChildren()
public void setDisplayPoint(IlvDataSet dataSet, int dataIndex, double xCoord, double yCoord)
setDisplayPoint
in class IlvChartRenderer
dataSet
- The considered data set.dataIndex
- The index of the considered data point within the data set.xCoord
- The new x-coordinate of the projected point, as displayed
by this renderer.yCoord
- The new y-coordinate of the projected point, as displayed
by this renderer.IlvDisplayPoint.setCoords(int, int)
public void setDataPoint(IlvDataSet dataSet, int dataIndex, double xData, double yData)
setDataPoint
in class IlvChartRenderer
dataSet
- The considered data set.dataIndex
- The index of the considered data point within the data set.xData
- The new x-value.yData
- The new y-value.public void draw(Graphics dst)
Graphics
.
The method delegates the drawing operation to each child renderer.draw
in class IlvChartRenderer
dst
- The destination Graphics
. May be null
if the renderer is drawn in a 3D scene.public void drawAnnotations(Graphics dst)
Graphics
.
The method delegates the drawing operation to each child renderer.drawAnnotations
in class IlvChartRenderer
@Deprecated public void draw(Graphics dst, IlvDataSet dataSet, int iMin, int iMax)
draw
in class IlvChartRenderer
public Rectangle2D getBounds(Rectangle2D bounds, boolean includeAnnotations)
null
, a new
Rectangle2D
is allocated.
Note that the bounds may be larger than necessary. There is no guarantee that the bounds returned are tight.
Note about multi-threading: This method must not take the Swing
tree lock, and must not access IlvChart
API that is
not multithread-safe.
getBounds
in class IlvChartRenderer
bounds
- An optional rectangle used to store the result.includeAnnotations
- Indicates whether annotation bounds should be included.public Rectangle2D getBounds(IlvDataSet dataSet, int iMin, int iMax, Rectangle2D bounds, boolean includeAnnotations)
null
, a new
Rectangle2D
is allocated.
Note that the bounds may be larger than necessary. There is no guarantee that the bounds returned are tight.
Note about multi-threading: This method must not take the Swing
tree lock, and must not access IlvChart
API that is
not multithread-safe.
getBounds
in class IlvChartRenderer
dataSet
- The data set containing the data points.iMin
- The minimum data point index.iMax
- The maximum data point index.bounds
- An optional rectangle used to store the result.includeAnnotations
- Indicates whether annotation bounds should be included.public void drawSelectionHandles(Graphics g, IlvHandlesSelectionStyle style)
drawSelectionHandles
in interface IlvChartAreaAccessible
drawSelectionHandles
in class IlvChartRenderer
g
- A graphics context.style
- The graphic style parameters.public IlvDisplayPoint getNearestPoint(IlvChartDataPicker picker)
getNearestPoint
in class IlvChartRenderer
picker
- The object holding the picking information.null
if none is found.IlvChartRenderer.getNearestItem(IlvChartDataPicker, double[])
public IlvDisplayPoint getNearestItem(IlvChartDataPicker picker, double[] distanceResult)
getNearestPoint(ilog.views.chart.IlvChartDataPicker)
method, this method considers the
geometry of the renderer drawing to compute the result. It also optionally
returns the distance to the renderer drawing.getNearestItem
in class IlvChartRenderer
picker
- The object holding the picking information.distanceResult
- If not null
, this will be used to
return the distance to the rendering of the item.
You can pass null
if you don't need
this information.null
if none was found.IlvChartRenderer.getNearestPoint(IlvChartDataPicker)
,
IlvChartRenderer.getDisplayItem(IlvChartDataPicker)
public IlvDisplayPoint getDisplayItem(IlvChartDataPicker picker)
getNearestPoint(ilog.views.chart.IlvChartDataPicker)
method, this method takes into account the
geometry of the renderer drawing to compute the result.
Unlike the getNearestItem(ilog.views.chart.IlvChartDataPicker, double[])
method, this method does not consider
the picker's pick distance.getDisplayItem
in class IlvChartRenderer
picker
- The object holding the picking information.null
if none is found.IlvChartRenderer.getNearestItem(IlvChartDataPicker, double[])
public void collectDisplayItems(IlvChartDataPicker picker, ArrayList<IlvDisplayPoint> accumulator)
getDisplayItem(IlvChartDataPicker)
, except that
it returns all items, if several renderers happen to show an item at or
near the same point.
The first collected point is the same as the one returned by
getDisplayItem(IlvChartDataPicker)
.collectDisplayItems
in class IlvChartRenderer
picker
- The object holding the picking information.accumulator
- A list to which the found display items will be added.public IlvDisplayPoint getDisplayPoint(IlvDataSet dataSet, int dataIdx)
getDisplayPoint
in class IlvChartRenderer
public IlvDataInterval getXRange(IlvDataInterval retRange)
getXRange
in class IlvChartRenderer
retRange
- An interval used to store the result. If this parameter
is null
, a new IlvDataInterval
is allocated.public IlvDataInterval getYRange(IlvDataInterval retRange)
getYRange
in class IlvChartRenderer
retRange
- An interval used to store the result. If this parameter
is null
, a new IlvDataInterval
is allocated.public IlvDataInterval getYRange(IlvDataInterval xRange, IlvDataInterval retRange)
getYRange
in class IlvChartRenderer
xRange
- The X interval used to select the points.retRange
- An interval used to store the result. If this parameter
is null
, a new IlvDataInterval
is allocated.public void drawLegendSymbol(IlvLegendItem item, Graphics g, int x, int y, int w, int h)
IlvRendererLegendItem
instances to draw the item symbol.drawLegendSymbol
in class IlvChartRenderer
item
- The legend item to draw.g
- The graphics context.x
- The symbol x-coordinate.y
- The symbol y-coordinate.w
- The symbol width.h
- The symbol height.IlvRendererLegendItem
public IlvLegendItem[] createLegendItems()
createLegendItems
method.createLegendItems
in class IlvChartRenderer
null
.IlvLegend
,
IlvLegendItem
public String getLegendText(IlvLegendItem item)
getLegendText
in class IlvChartRenderer
public void addImageMapAreas(IlvIMapDefinition mapDef, List<? super IlvIMapArea> areaList)
addImageMapAreas
in class IlvChartRenderer
mapDef
- The map definition.areaList
- The list of map areas. The method must add instances
of IlvIMapArea
to this list.public void drawIntoHitmap(IlvChartHitmapDefinition definition, IlvChartHitmapAccumulator accumulator)
drawIntoHitmap
in class IlvChartRenderer
definition
- The specification how to construct the hitmap.accumulator
- The object that accumulates objects in the hitmap.IlvChartHitmapDefinition.drawIntoHitmap(IlvChart, IlvChartRenderer, IlvChartHitmapAccumulator)
public void setAnnotation(IlvDataSet dataSet, int idx, IlvDataAnnotation annotation)
setAnnotation
in class IlvChartRenderer
dataSet
- The considered data set.idx
- The index of the considered point in the data set.annotation
- The new annotation, or null
if the
annotation associated with the specified point must be removed.
If an annotation has already been specified globally with the
IlvChartRenderer.setAnnotation(IlvDataSet, IlvDataAnnotation)
method,
it is overridden by this new annotation.
In that case, a null
value has no effect.public void setAnnotation(IlvDataSet dataSet, IlvDataAnnotation annotation)
setAnnotation
in class IlvChartRenderer
dataSet
- The considered data set.annotation
- The new annotation, or null
if the
global annotation must be removed.IlvChartRenderer.setAnnotation(IlvDataAnnotation)
public IlvDataAnnotation getAnnotation(IlvDataSet dataSet, int idx)
getAnnotation
in class IlvChartRenderer
dataSet
- The considered data set.idx
- The index of the point within the data set.public boolean holdsAnnotations()
holdsAnnotations
in class IlvChartRenderer
public void setRenderingHint(IlvDataSet dataSet, int idx, IlvDataRenderingHint hint)
setRenderingHint
in class IlvChartRenderer
dataSet
- The considered data set.idx
- The index of the considered point in the data set.hint
- The new rendering hint, or null
if the
hint associated with the specified point must be removed.
If an hint has already been specified globally with the
IlvChartRenderer.setRenderingHint(IlvDataSet, IlvDataRenderingHint)
} method,
it is overridden by this new hint.
In that case, a null
value has no effect.public void setRenderingHint(IlvDataSet dataSet, IlvDataRenderingHint hint)
setRenderingHint
in class IlvChartRenderer
dataSet
- The considered data set.hint
- The new rendering hint, or null
if the
global hint must be removed.public IlvDataRenderingHint getRenderingHint(IlvDataSet dataSet, int idx)
getRenderingHint
in class IlvChartRenderer
dataSet
- The considered data set.idx
- The index of the point within the data set.null
for none.public IlvDataRenderingHint getRenderingHint(IlvDataSet dataSet)
getRenderingHint
in class IlvChartRenderer
dataSet
- The considered data set.null
for none.© Copyright Rogue Wave Software, Inc. 1997, 2018. All Rights Reserved.