com.steema.teechart.styles
Class Bubble

java.lang.Object
  extended by com.steema.teechart.TeeBase
      extended by com.steema.teechart.styles.Series
          extended by com.steema.teechart.styles.CustomPoint
              extended by com.steema.teechart.styles.Points
                  extended by com.steema.teechart.styles.Bubble
All Implemented Interfaces:
ISeries, java.io.Serializable, java.lang.Cloneable

public class Bubble
extends Points

Title: class

Description: Bubble Series.

Example:


   bubbleSeries = new com.steema.teechart.styles.Bubble(myChart.getChart());

   bubbleSeries.getXValues().setDateTime(true);
   bubbleSeries.getRadiusValues().setDateTime(false);
   bubbleSeries.getRadiusValues().setName("Radius");
   bubbleSeries.getRadiusValues().setOrder(ValueListOrder.NONE);
   bubbleSeries.setHorizontalAxis(HorizontalAxis.TOP);
   bubbleSeries.getMarks().setArrowLength(0);
   bubbleSeries.getMarks().setClip(true);
   bubbleSeries.getMarks().getFont().setColor(Color.WHITE);
   bubbleSeries.getMarks().getFont().setSize(16);
   bubbleSeries.getMarks().getFont().setItalic(true);
   bubbleSeries.getMarks().getFrame().setVisible(false);
   bubbleSeries.getMarks().setTransparent(true);
   bubbleSeries.getMarks().setVisible(false);
   bubbleSeries.getPointer().setHorizSize(14);
   bubbleSeries.getPointer().setVertSize(14);
   bubbleSeries.getPointer().setInflateMargins(false);
   bubbleSeries.setVisible(true);
 

Copyright (c) 2005-2008 by Steema Software SL. All Rights Reserved.

Company: Steema Software SL

See Also:
Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from class com.steema.teechart.styles.Series
Series.MarkTextResolver
 
Field Summary
protected  ChartPen linePen
           
protected  TreatNullsStyle treatnulls
           
 
Fields inherited from class com.steema.teechart.styles.CustomPoint
iStacked, point
 
Fields inherited from class com.steema.teechart.styles.Series
AUTODEPTH, AUTOZORDER, bActive, bBrush, bColorEach, calcVisiblePoints, colorMember, customMarkText, drawBetweenPoints, endZ, firstVisible, hasZValues, iColors, InternalUse, iNumSampleValues, iZOrder, labelMember, lastVisible, listenerList, mandatory, manualData, marks, middleZ, notMandatory, percentDecimal, percentFormat, sLabels, startZ, useAxis, useSeriesColor, valueFormat, vxValues, vyValues, yMandatory
 
Fields inherited from class com.steema.teechart.TeeBase
chart
 
Constructor Summary
Bubble()
           
Bubble(IBaseChart c)
           
 
Method Summary
 int add(double x, double y, double radius)
          Adds a new Bubble point to the Series Points List.
The Bubble point is assigned to be at AX, AY coordinates and has ARadius parameter.
 int add(double x, double y, double radius, Color color)
          Adds a new Bubble point to the Series Points List and color.
The Bubble point is assigned to be at AX, AY coordinates and have ARadius and Color parameters.
 int add(double x, double y, double radius, java.lang.String text)
          Adds a new Bubble point to the Series Points List and label.
The Bubble point is assigned to be at AX, AY coordinates and have ARadius and Label parameters.
 int add(double x, double y, double radius, java.lang.String text, Color color)
          Adds a new Bubble point to the Series Points List, label and color.
The Bubble point is assigned to be at AX, AY coordinates and have ARadius, Label and Color parameters.
protected  void addSampleValues(int numValues)
           
protected  double calcMinMaxValue(boolean isMin)
           
 boolean clickedPointer(int valueIndex, int tmpX, int tmpY, int x, int y)
          For internal use
protected  void drawLegendShape(IGraphics3D g, int valueIndex, Rectangle r)
           
 void drawValue(int valueIndex)
          Called internally.
 boolean getColorEach()
          Controls which color will be drawn on the bubbles.
If false, all points will be drawn using Series Series.Color.
 java.lang.String getDescription()
          Gets descriptive text.
 double getMaxYValue()
          The Maximum Value of the Series Y Values List.
 double getMaxZValue()
          The maximum Z value.
 double getMinYValue()
          The Minimum Value of the Series Y Values List.
 double getMinZValue()
          The minimum Z value.
 ValueList getRadiusValues()
          A TList object that stores each Bubble point Radius value.
You can change Radius values by using the RadiusValues.Value[] array of doubles method
 boolean getSquared()
          Determines how the Bubble size is calculated.
By default, the horizontal and vertical Bubble sizes are equal to the radius of each bubble.
 TreatNullsStyle getTreatNulls()
          Defines how null points are treated.
 boolean isValidSourceOf(ISeries value)
          It's used to validate the DataSource property both at design and run-time.
protected  int numSampleValues()
           
 void setRadiusValues(ValueList value)
          A TList object that stores each Bubble point Radius value.
 void setSquared(boolean value)
          Determines how the Bubble size is calculated.
Default value: true
 void setTreatNulls(TreatNullsStyle value)
           
 
Methods inherited from class com.steema.teechart.styles.Points
canDoExtra, createSubGallery, getColor, getLinePen, setColor, setColorEach, setSubGallery
 
Methods inherited from class com.steema.teechart.styles.CustomPoint
addSeriesMouseListener, assign, calcHorizMargins, calcVerticalMargins, calcXPos, calcYPos, calcZOrder, clicked, drawMark, drawPointer, getMaxXValue, getMinXValue, getOriginPos, getPointer, getStacked, onGetPointerStyle, removePointerStyleResolver, removeSeriesMouseListener, sameClassOrigin, setChart, setPointerStyleResolver, setStacked
 
Methods inherited from class com.steema.teechart.styles.Series
add, add, add, add, add, add, add, add, add, add, add, add, add, add, add, add, add, add, add, add, add, add, add, add, add, addChartValue, added, addedValue, addNull, addNullXY, addSeriesPaintListener, addValues, assignDispose, assignValues, associatedToAxis, beginUpdate, calcFirstLastVisibleIndex, calcPosValue, CalculateMarkPosition, calcXPosValue, calcXSizeValue, calcYPosValue, calcYSizeValue, canAddRandomPoints, changeType, checkDataSource, checkMouse, checkOrder, checkOtherSeries, clear, clearLists, clicked, clone, cloneSeries, convertArray, createNewSeries, createNewSeries, dataSourceArray, delete, delete, delete, dispose, doAfterDrawValues, doBeforeDrawChart, doBeforeDrawValues, doClick, doClickPointer, doDoubleClick, draw, drawLegend, drawLegend, drawMarks, drawMarksSeries, drawSeries, drawSeriesForward, drawValuesForward, endUpdate, fillSampleValues, fillSampleValues, fireSeriesMouseEvent, fireSeriesPaint, firstDisplayed, galleryChanged3D, getActive, getAllowSinglePoint, getBitmapEditor, getColorMember, getColors, getCount, getCountLegendItems, getCursor, getCustomHorizAxis, getCustomVertAxis, getDataSource, getDefaultColor, getDefaultNullValue, getDepth, getEndZ, getFields, getFirstVisible, getFunction, getHasZValues, getHorizAxis, getHorizontalAxis, getLabelMember, getLabels, getLastVisible, getLegendString, getMandatory, getMandatoryAxis, getMarks, getMarkText, getMarkValue, getMiddleZ, getNotMandatory, getNumGallerySeries, getNumSampleValues, getOriginValue, getPercentFormat, getPoint, getSeriesColor, getShowInLegend, getStartZ, getTitle, getUseAxis, getValueColor, getValueFormat, getValueIndexSwapper, getValueList, getValueList, getValueMarkText, getValuesLists, getVertAxis, getVerticalAxis, getVisible, getXValues, getYMandatory, getYValueList, getYValues, getZOrder, hasClickEvents, hasDataSource, hasListenersOf, hasNoMandatoryValues, isNull, isValidSeriesSource, isValidSourceOf, lastDisplayed, legendItemColor, legendToValueIndex, maxMarkWidth, moreSameZOrder, mouseEvent, newFromType, onDisposing, paintLegend, prepareForGallery, prepareLegendCanvas, randomBounds, readResolve, recalcGetAxis, refreshSeries, removeMarkTextResolver, removeSeriesPaintListener, repaint, sameClass, setActive, setColorMember, setColors, setCursor, setCustomHorizAxis, setCustomHorizAxis, setCustomVertAxis, setCustomVertAxis, setDataSource, setDefaultNullValue, setDepth, setEndZ, setFunction, setHorizontal, setHorizontalAxis, setLabelMember, setLabels, setMarks, setMarkTextResolver, setMiddleZ, setNull, setNull, setPercentFormat, setSeriesColor, setShowInLegend, setStartZ, setTitle, setValueFormat, setValueList, setVerticalAxis, setVisible, setXValues, setYValues, setZOrder, setZPositions, sortByLabels, sortByLabels, swapValueIndex, titleOrName, toString, valuesListAdd, xScreenToValue, yScreenToValue
 
Methods inherited from class com.steema.teechart.TeeBase
getChart, invalidate, setBooleanProperty, setColorProperty, setColorProperty, setDoubleProperty, setIntegerProperty, setStringProperty
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface com.steema.teechart.styles.ISeries
getChart, invalidate
 

Field Detail

linePen

protected ChartPen linePen

treatnulls

protected TreatNullsStyle treatnulls
Constructor Detail

Bubble

public Bubble()

Bubble

public Bubble(IBaseChart c)
Method Detail

clickedPointer

public boolean clickedPointer(int valueIndex,
                              int tmpX,
                              int tmpY,
                              int x,
                              int y)
Description copied from class: CustomPoint
For internal use

Overrides:
clickedPointer in class CustomPoint
Parameters:
valueIndex - int
tmpX - int
tmpY - int
x - int
y - int
Returns:
boolean

getSquared

public boolean getSquared()
Determines how the Bubble size is calculated.
By default, the horizontal and vertical Bubble sizes are equal to the radius of each bubble. When Squared is false, Bubble horizontal and vertical sizes are calculated independently based on Series axis scales.
Default value: true

Returns:
boolean

setSquared

public void setSquared(boolean value)
Determines how the Bubble size is calculated.
Default value: true

Parameters:
value - boolean

numSampleValues

protected int numSampleValues()
Overrides:
numSampleValues in class Series

addSampleValues

protected void addSampleValues(int numValues)
Overrides:
addSampleValues in class Series

drawLegendShape

protected void drawLegendShape(IGraphics3D g,
                               int valueIndex,
                               Rectangle r)
Overrides:
drawLegendShape in class CustomPoint

drawValue

public void drawValue(int valueIndex)
Called internally. Draws the "ValueIndex" point of the Series.

Specified by:
drawValue in interface ISeries
Overrides:
drawValue in class CustomPoint
Parameters:
valueIndex - int

add

public int add(double x,
               double y,
               double radius,
               Color color)
Adds a new Bubble point to the Series Points List and color.
The Bubble point is assigned to be at AX, AY coordinates and have ARadius and Color parameters. The Label parameter is used to draw Axis Labels, Bubble Marks and Legend.

Parameters:
x - double x coordinate of bubble point.
y - double y coordinate of bubble point.
radius - double
color - Color
Returns:
int

add

public int add(double x,
               double y,
               double radius)
Adds a new Bubble point to the Series Points List.
The Bubble point is assigned to be at AX, AY coordinates and has ARadius parameter. The Label parameter is used to draw Axis Labels, Bubble Marks and Legend.

Parameters:
x - double x coordinate of bubble point.
y - double y coordinate of bubble point.
radius - double
Returns:
int

add

public int add(double x,
               double y,
               double radius,
               java.lang.String text)
Adds a new Bubble point to the Series Points List and label.
The Bubble point is assigned to be at AX, AY coordinates and have ARadius and Label parameters. The Label parameter is used to draw Axis Labels, Bubble Marks and Legend.

Parameters:
x - double x coordinate of bubble point.
y - double y coordinate of bubble point.
radius - double
text - String
Returns:
int

add

public int add(double x,
               double y,
               double radius,
               java.lang.String text,
               Color color)
Adds a new Bubble point to the Series Points List, label and color.
The Bubble point is assigned to be at AX, AY coordinates and have ARadius, Label and Color parameters. The Label parameter is used to draw Axis Labels, Bubble Marks and Legend.

Parameters:
x - double x coordinate of bubble point.
y - double y coordinate of bubble point.
radius - double
text - String
color - Color
Returns:
int

isValidSourceOf

public boolean isValidSourceOf(ISeries value)
It's used to validate the DataSource property both at design and run-time.
It returns false if the Value parameter is the same as Self.

Parameters:
value - ISeries
Returns:
boolean

getMaxYValue

public double getMaxYValue()
The Maximum Value of the Series Y Values List.

Overrides:
getMaxYValue in class CustomPoint
Returns:
double

getMinYValue

public double getMinYValue()
The Minimum Value of the Series Y Values List.

Overrides:
getMinYValue in class CustomPoint
Returns:
double

getMaxZValue

public double getMaxZValue()
The maximum Z value.

Specified by:
getMaxZValue in interface ISeries
Overrides:
getMaxZValue in class Series
Returns:
double

getMinZValue

public double getMinZValue()
The minimum Z value.

Specified by:
getMinZValue in interface ISeries
Overrides:
getMinZValue in class Series
Returns:
double

getRadiusValues

public ValueList getRadiusValues()
A TList object that stores each Bubble point Radius value.
You can change Radius values by using the RadiusValues.Value[] array of doubles method

Returns:
ValueList

setRadiusValues

public void setRadiusValues(ValueList value)
A TList object that stores each Bubble point Radius value.

Parameters:
value - ValueList

getColorEach

public boolean getColorEach()
Controls which color will be drawn on the bubbles.
If false, all points will be drawn using Series Series.Color. If true, each Series point will be "colored" with its corresponding point color.
You can change this property both at design and runtime.
Default value: true

Specified by:
getColorEach in interface ISeries
Overrides:
getColorEach in class Series
Returns:
boolean

getDescription

public java.lang.String getDescription()
Gets descriptive text.

Overrides:
getDescription in class Points
Returns:
String

calcMinMaxValue

protected double calcMinMaxValue(boolean isMin)

getTreatNulls

public TreatNullsStyle getTreatNulls()
Defines how null points are treated.

Returns:
TreatNullsStyle

setTreatNulls

public void setTreatNulls(TreatNullsStyle value)