All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class jclass.chart.JCChart

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.Container
                   |
                   +----java.awt.Panel
                           |
                           +----jclass.bwt.JCContainer
                                   |
                                   +----jclass.chart.JCChart

public class JCChart

extends JCContainer

implements Changeable, JCSerializable, MouseListener, MouseMotionListener

AREA

BAR

browser

BROWSER_APPLETVIEWER

BROWSER_EXPLORER

BROWSER_INTERPRETER

BROWSER_NETSCAPE

BROWSER_OTHER

BROWSER_UNIX

BROWSER_UNKNOWN

CANDLE

FILLED_RADAR

HILO

HILO_OPEN_CLOSE

NONE

os

PIE

PLOT

POLAR

RADAR

SCATTER_PLOT

STACKING_BAR

version

JCChart()

Default constructor, required by Java Beans

JCChart(Applet, String)

Constructor so that we can get property values from the HTML file

JCChart(int)

Constructor that creates a JCChart of a particular type.

addChartLabel(JCChartLabel)

addChartListener(JCChartListener)

addDataView(int)

DEPRECATED Method for adding a data view Deprecated.

addPickListener(JCPickListener)

addTrigger()

Adds a new event trigger to the Triggers property.

cancel()

Performs a cancel on the chart.

exportAsGIF(OutputStream)

findDataView(String)

Method used to find a data view given its name

getAbout()

Gets the value of the About property The About property displays contact information for KL group in the bean box.

getAllowUserChanges()

Gets the value of the AllowUserChanges property, which determines whether the user viewing the graph can modify graph values.

getBottomMargin()

Gets the BottomMargin property.

getCancelKey()

Gets the value of the CancelKey property.

getChanged()

Gets the value of the Changed property, which determines whether the chart requires a recalculation.

getChartArea()

Gets the value of the ChartArea property.

getDataView()

Gets the value of the DataView property.

getDataView(int)

Gets the value of the Data property.

getDoubleBuffer()

Gets the value of the DoubleBuffer property

getFooter()

Sets the Footer property.

getHeader()

Gets the Header property.

getIsBatched()

Gets the value of the IsBatched property.

getLeftMargin()

Gets the LeftMargin property.

getLegend()

Gets the Legend property The Legend property controls the object that controls the display of the legend.

getNumData()

Gets the value of the NumData property.

getNumTriggers()

Gets the NumTriggers property, which indicates how many event triggers have been specified.

getOffset()

Gets the value of the Offset property.

getParameters()

To read the property/parameter values from the HTML file

getResetKey()

Gets the value of the ResetKey property.

getRightMargin()

Gets the RightMargin property.

getTopMargin()

Gets the TopMargin property.

getTrigger(int)

Gets a single trigger from the Triggers property of JCChart.

insets()

Returns the chart margins.

isChanged()

Gets the value of the Changed property, which determines whether the chart requires a recalculation.

layout()

JCChart layout method.

layoutLegend(Point, Dimension, Point, Dimension)

Lays out the chart legend by modifying the provided Point and Dimension parameters.

locate(int, int)

minimumSize()

Calculates and returns the minimum size of the chart component.

mouseClicked(MouseEvent)

mouseDown(Event, int, int)

If currently over an URL anchor, returns.

mouseDragged(MouseEvent)

mouseEntered(MouseEvent)

mouseExited(MouseEvent)

mouseMove(Event, int, int)

mouseMoved(MouseEvent)

mousePressed(MouseEvent)

mouseReleased(MouseEvent)

mouseUp(Event, int, int)

If currently over an URL anchor, display it.

paint(Graphics)

The top-level paint routine in JCChart.

pick(Point, ChartDataView)

Given a screen position in pixels, returns a JCDataIndex object which represents the closest point in a data series in the specified ChartDataView instance.

preferredSize()

Calculates and returns the preferred size of the chart component.

print(Graphics)

printAll(Graphics)

processMouseEvent(MouseEvent)

recalc()

If necessary, forces recalculation of the entire chart by calling the recalc() method for its components.

removeChartLabel(JCChartLabel)

removeChartListener(JCChartListener)

removeDataView(int)

Removes a ChartDataView from the index specified.

removePickListener(JCPickListener)

removeTrigger(int)

Removes the event trigger at the specified index.

reset()

Performs a reset on the chart.

rotate()

A call to rotate a graph to the specified locations.

rotateEnd()

A call to signify the end of a rotate event.

rotateStart()

A call to signify the beginning of a rotate event.

scale(double, JCAxis, boolean)

Performs a scale operation.

setAbout(String)

Sets the value of the About property The About property displays contact information for KL group in the bean box.

setAllowUserChanges(boolean)

Sets the value of the AllowUserChanges property, which determines whether the user viewing the graph can modify graph values.

setBottomMargin(int)

Sets the BottomMargin property.

setCancelKey(int)

Sets the value of the CancelKey property.

setChanged(boolean)

Sets the value of the Changed property, which determines whether the chart requires to be recalculated.

setChanged(boolean, boolean)

Sets the value of the Changed property, which determines whether the chart requires to be recalculated.

setChartArea(JCChartArea)

Sets the value of the ChartArea property.

setDataView(ChartDataView[])

Sets the value of the DataView property.

setDataView(int, ChartDataView)

Creates a new ChartDataView and adds it at the index specified.

setDoubleBuffer(boolean)

Sets the DoubleBuffereproperty, which controls whether the chart rendering uses an off-screen image or renders directly to the screen.

setFooter(JCTitle)

Sets the Footer property.

setHeader(JCTitle)

Sets the Header property.

setIsBatched(boolean)

Sets the value of the IsBatched property, which controls whether chart updates are accumulated.

setLeftMargin(int)

Sets the LeftMargin property.

setLegend(JCLegend)

Sets the Legend property The Legend property controls the object that controls the display of the legend.

setOffset(int)

Sets the value of the Offset property.

setResetKey(int)

Sets the value of the ResetKey property.

setRightMargin(int)

Sets the RightMargin property.

setTopMargin(int)

Sets the TopMargin property.

setTrigger(int, EventTrigger)

Sets the value of the Trigger property at a specified index.

snapshot()

translate(double, JCAxis, boolean)

A call to perform a translation of a specified amount along the specified axis.

translateStart(JCAxis)

A call to signify the start of a translate event.

unpick(ChartDataView, int, int)

Returns the position in screen pixels of a particular point in a particular data series.

unpick(int, ChartDataViewSeries)

Returns the position in screen pixels of a particular point in a particular data series.

update()

Forces the chart to re-layout and recalculate.

zoom(double, double, JCAxis, boolean)

Performs a zoom operation along the specified axis

  public final static int NONE

  public final static int PLOT

  public final static int SCATTER_PLOT

  public final static int POLAR

  public final static int RADAR

  public final static int FILLED_RADAR

  public final static int HILO

  public final static int HILO_OPEN_CLOSE

  public final static int CANDLE

  public final static int AREA

  public final static int BAR

  public final static int STACKING_BAR

  public final static int PIE

  public final static String version

  public final static int BROWSER_UNKNOWN

  public final static int BROWSER_OTHER

  public final static int BROWSER_INTERPRETER

  public final static int BROWSER_APPLETVIEWER

  public final static int BROWSER_NETSCAPE

  public final static int BROWSER_EXPLORER

  public final static int BROWSER_UNIX

  public static int os

  public static int browser

  public JCChart(int tp)

Constructor that creates a JCChart of a particular type. Note that the ChartType is actually a property of ChartDataView. This constructor is provided as a convenience.

Parameters:

tp - the chart type

See Also:

ChartDataView

  public JCChart()

Default constructor, required by Java Beans

  public JCChart(Applet applet,
                 String name)

Constructor so that we can get property values from the HTML file

Parameters:

applet - the applet that this chart is contained in

name - a name for this chart

  public void processMouseEvent(MouseEvent e)

Overrides:

processMouseEvent in class JCContainer

  public void mousePressed(MouseEvent event)

  public void mouseClicked(MouseEvent event)

  public void mouseReleased(MouseEvent event)

  public void mouseEntered(MouseEvent event)

  public void mouseExited(MouseEvent event)

  public void mouseDragged(MouseEvent event)

  public void mouseMoved(MouseEvent event)

  protected void getParameters()

To read the property/parameter values from the HTML file

Overrides:

getParameters in class JCContainer

  public final boolean isChanged()

Gets the value of the Changed property, which determines whether the chart requires a recalculation.

  public boolean getChanged()

Gets the value of the Changed property, which determines whether the chart requires a recalculation.

  public void recalc()

If necessary, forces recalculation of the entire chart by calling the recalc() method for its components.

  public void setChanged(boolean n)

Sets the value of the Changed property, which determines whether the chart requires to be recalculated. This value is propagated to all child components.

Parameters:

n - boolean value of the Changed property

  public void setChanged(boolean n,
                         boolean updateParent)

Sets the value of the Changed property, which determines whether the chart requires to be recalculated. This value is propagated to all the child components. Note: This method is mandated by the Changeable interface, but has no use in JCChart. It is usually used for cases in which the Changed property must be changed without forcing a recalculation.

Parameters:

n - boolean value of the Changed property

  public void paint(Graphics gc)

The top-level paint routine in JCChart.

Overrides:

paint in class JCContainer

  public void printAll(Graphics g)

Overrides:

printAll in class JCContainer

  public void print(Graphics pg)

Overrides:

print in class Container

  public void layout()

JCChart layout method. It lays out the header, footer, legend and chart area.

Overrides:

layout in class Container

  public Dimension preferredSize()

Calculates and returns the preferred size of the chart component.

Returns:

the preferred size of the chart component

Overrides:

preferredSize in class JCContainer

  public Dimension minimumSize()

Calculates and returns the minimum size of the chart component.

Returns:

the minimum size of the chart component

Overrides:

minimumSize in class JCContainer

  public synchronized void setIsBatched(boolean bt)

Sets the value of the IsBatched property, which controls whether chart updates are accumulated.

Parameters:

bt - if true, it will accumulate chart updates. If false, it forces the accumulated updates to be processed.

  public boolean getIsBatched()

Gets the value of the IsBatched property.

Returns:

true if updates are being accumulated, if false, updates are not accumulated

  public void update()

Forces the chart to re-layout and recalculate.

  public synchronized void setDoubleBuffer(boolean db)

Sets the DoubleBuffereproperty, which controls whether the chart rendering uses an off-screen image or renders directly to the screen.

Parameters:

db - if true, an off-screen image is used for chart rendering. If false, rendering occurs directly on the screen.

  public boolean getDoubleBuffer()

Gets the value of the DoubleBuffer property

Returns:

true if double buffering is active, false otherwise

  public synchronized void setAllowUserChanges(boolean change)

Sets the value of the AllowUserChanges property, which determines whether the user viewing the graph can modify graph values.

Parameters:

change - true means the user is allowed to modify graph values. If false, the user is not allowed to modify graph values.

  public boolean getAllowUserChanges()

Gets the value of the AllowUserChanges property, which determines whether the user viewing the graph can modify graph values.

Returns:

true if the user is allowed to modify the graph values, false otherwise

  public JCTitle getHeader()

Gets the Header property. The Header property controls the object that controls the display of the header.

Returns:

head the JCTitle object associated with the header

  public void setHeader(JCTitle head)

Sets the Header property. The Header property controls the object that controls the display of the header.

Parameters:

head - the JCTitle object associated with the header

  public JCTitle getFooter()

Sets the Footer property. The Footer property controls the object that controls the display of the footer.

Returns:

the JCTitle object associated with the footer

  public void setFooter(JCTitle foot)

Sets the Footer property. The Footer property controls the object that controls the display of the footer.

Parameters:

foot - the JCTitle object associated with the footer

  public JCLegend getLegend()

Gets the Legend property The Legend property controls the object that controls the display of the legend.

Returns:

the JCLegend object associated with the legend

  public void setLegend(JCLegend jl)

Sets the Legend property The Legend property controls the object that controls the display of the legend.

Parameters:

jl - the JCLegend object associated with the legend

  public JCChartArea getChartArea()

Gets the value of the ChartArea property. The ChartArea property controls the object that controls the display of the graph.

Returns:

the JCChartArea object associated with this JCChart.

  public void setChartArea(JCChartArea ca)

Sets the value of the ChartArea property. The ChartArea property controls the object that controls the display of the graph.

Returns:

the JCChartArea object associated with this JCChart.

  public ChartDataView getDataView(int index)

Gets the value of the Data property. The Data property is an indexed property of JCChart that contains one or more ChartDataView objects. Each ChartDataView object controls the display of data using a particular chart type.

Parameters:

index - index of the data object to return

Returns:

ChartDataView object

  public ChartDataView addDataView(int index)

Note: addDataView() is deprecated. use something else (?)

DEPRECATED Method for adding a data view

  public synchronized void setDataView(int index,
                                       ChartDataView ndv)

Creates a new ChartDataView and adds it at the index specified. The act of adding a new ChartDataView to the JCChart will cause all existing ChartDataView objects to re-order themselves.

Parameters:

index - position at which to add the new object

ndv - New data view object

Returns:

new ChartDataView object

Throws: IllegalArgumentException

If the index does not address a valid ChartDataView.

  public synchronized void setDataView(ChartDataView views[])

Sets the value of the DataView property. The DataView property is an indexed property that contains all the data to be displayed in Chart.

Parameters:

views - array of data views to be included in the DataView property.

  public ChartDataView findDataView(String name)

Method used to find a data view given its name

  public ChartDataView[] getDataView()

Gets the value of the DataView property. The DataView property is an indexed property that contains all the data to be displayed in Chart.

Returns:

array of data views that are included in the DataView property

  public void removeDataView(int index)

Removes a ChartDataView from the index specified. The act of removing a ChartDataView to the JCChart will cause all existing ChartDataView objects to re-order themselves.

Parameters:

index - position from which to remove the object

  public int getNumData()

Gets the value of the NumData property. The NumData property indicates how many ChartDataView objects are stored in JCChart. It is a read-only property.

Returns:

number of ChartDataView objects inside this JCChart instance

  public EventTrigger getTrigger(int index)

Gets a single trigger from the Triggers property of JCChart. The Triggers property is an indexed property that contains a series of mappings from AWT events to JCChart actions.

Parameters:

index - index of trigger

Returns:

EventTrigger instance

  public int getNumTriggers()

Gets the NumTriggers property, which indicates how many event triggers have been specified.

Returns:

number of EventTrigger instances in the Triggers property

  public EventTrigger addTrigger()

Adds a new event trigger to the Triggers property.

Returns:

EventTrigger instance, to be manipulated by the developer

  public synchronized void setTrigger(int index,
                                      EventTrigger trig)

Sets the value of the Trigger property at a specified index. The Trigger property is an indexed property, and int contains all the information necessary to map user events into Chart actions. The Trigger property is made up of a number of EventTrigger objects.

Parameters:

index - index within the Trigger property

trig - EventTrigger object to be placed at the specified index

Throws: IllegalArgumentException

If the index does not address a valid event trigger.

  public void removeTrigger(int index)

Removes the event trigger at the specified index.

Parameters:

index - index of the EventTrigger instance to be removed

  public synchronized void setResetKey(int k)

Sets the value of the ResetKey property. The ResetKey property specifies the key used to perform a reset operation.

Parameters:

k - Key that will trigger a reset

  public int getResetKey()

Gets the value of the ResetKey property. The ResetKey property specifies the key used to perform a reset operation.

Returns:

Key that will trigger a reset

  public synchronized void setCancelKey(int k)

Sets the value of the CancelKey property. The CancelKey property specifies the key used to perform a cancel operation.

Parameters:

k - Key that will trigger a cancel

  public int getCancelKey()

Gets the value of the CancelKey property. The CancelKey property specifies the key used to perform a cancel operation.

Returns:

Key that will trigger a cancel

  public void rotateStart()

A call to signify the beginning of a rotate event.

  public void rotate()

A call to rotate a graph to the specified locations.

Parameters:

rotation - rotation around the y axis

inclination - rotation above the x axis

  public void rotateEnd()

A call to signify the end of a rotate event.

  public void zoom(double start,
                   double end,
                   JCAxis axis,
                   boolean update)

Performs a zoom operation along the specified axis

Parameters:

start - new axis minimum value

end - new axis maximum value

axis - axis along which to perform zoom

update - if true, a redisplay is forced. If false, the redisplay does not occur. If translating along two axes, the first translate() call should have update=false, and the second should have update=true.

  public void scale(double sc,
                    JCAxis axis,
                    boolean update)

Performs a scale operation. A scale factor of 0.5 is 50% and makes everything smaller (zoom out), a scale factor of 2 is 200% and makes everything bigger (zoom in)

Parameters:

sc - scale percentage relative to the default appearance of the graph

  public void translateStart(JCAxis axis)

A call to signify the start of a translate event.

Parameters:

axis - axis along which to begin translating. Note that it is possible to translate along multiple axes simultaneously.

  public void translate(double delta,
                        JCAxis axis,
                        boolean update)

A call to perform a translation of a specified amount along the specified axis.

Parameters:

delta - amount to translate along the axis

axis - axis along which to perform the translation

update - if true, a redisplay is forced. If false, the redisplay does not occur. If translating along two axes, the first translate() call should have update=false, and the second should have update=true.

  public void reset()

Performs a reset on the chart. Returns the chart back to the default min and max.

  public void cancel()

Performs a cancel on the chart. Cancel will stop any current action.

  protected void layoutLegend(Point legendOrigin,
                              Dimension legendSize,
                              Point chartOrigin,
                              Dimension chartSize)

Lays out the chart legend by modifying the provided Point and Dimension parameters.

Parameters:

legendOrigin - coordinates of the upper left-hand corner of the legend

legendSize - size of the legend

chartOrigin - coordinates of the upper left-hand corner of the chart area

chartSize - size of the chart area

  public Insets insets()

Returns the chart margins.

Returns:

insets object representing the margins for the chart

Overrides:

insets in class JCContainer

  public synchronized void setTopMargin(int val)

Sets the TopMargin property. The TopMargin property controls the top margin on the chart.

Parameters:

val - top margin value

  public int getTopMargin()

Gets the TopMargin property. The TopMargin property controls the top margin on the chart.

Returns:

top margin value

  public synchronized void setLeftMargin(int val)

Sets the LeftMargin property. The LeftMargin property controls the left margin on the chart.

Parameters:

val - left margin value

  public int getLeftMargin()

Gets the LeftMargin property. The LeftMargin property controls the left margin on the chart.

Returns:

left margin value

  public synchronized void setRightMargin(int val)

Sets the RightMargin property. The RightMargin property controls the right margin on the chart.

Parameters:

val - right margin value

  public int getRightMargin()

Gets the RightMargin property. The RightMargin property controls the right margin on the chart.

Returns:

right margin value

  public synchronized void setBottomMargin(int val)

Sets the BottomMargin property. The BottomMargin property controls the bottom margin on the chart.

Parameters:

val - bottom margin value

  public int getBottomMargin()

Gets the BottomMargin property. The BottomMargin property controls the bottom margin on the chart.

Returns:

bottom margin value

  public int getOffset()

Gets the value of the Offset property. The Offset property controls the amount of space between chart components.

Returns:

Offset value

  public synchronized void setOffset(int no)

Sets the value of the Offset property. The Offset property controls the amount of space between chart components.

Parameters:

no - Offset value

  public String getAbout()

Gets the value of the About property The About property displays contact information for KL group in the bean box.

  public synchronized void setAbout(String s)

Sets the value of the About property The About property displays contact information for KL group in the bean box.

  public JCDataIndex pick(Point p,
                          ChartDataView data)

Given a screen position in pixels, returns a JCDataIndex object which represents the closest point in a data series in the specified ChartDataView instance. If no data view is supplied, all data views are considered when finding the closest point.

Parameters:

p - pick point in pixels relative to the JCChart object.

data - data view on which to perform pick. If null, all data views are used.

Returns:

JCDataIndex object representing the picked point.

  public Point unpick(ChartDataView dv,
                      int pt,
                      int series)

Returns the position in screen pixels of a particular point in a particular data series.

Parameters:

dv - the data view containing the specified series

pt - point index

series - data series index or JCPieChartFormat.OTHER_SLICE if specifying the other slice of a pie chart.

Returns:

AWT Point object representing position in screen pixels relative to the JCChart object or null if series or point does not exist or is not showing.

  public Point unpick(int pt,
                      ChartDataViewSeries series)

Returns the position in screen pixels of a particular point in a particular data series.

Parameters:

pt - point index

series - data series

Returns:

AWT Point object representing position in screen pixels relative to the JCChart object or null if series or point does not exist or is not showing.

  public void addChartListener(JCChartListener l)

  public void removeChartListener(JCChartListener l)

  public void addPickListener(JCPickListener l)

  public void removePickListener(JCPickListener l)

  public boolean mouseUp(Event event,
                         int x,
                         int y)

If currently over an URL anchor, display it.

Overrides:

mouseUp in class Component

  public boolean mouseDown(Event event,
                           int x,
                           int y)

If currently over an URL anchor, returns.

Overrides:

mouseDown in class Component

  public Component locate(int x,
                          int y)

Overrides:

locate in class Container

  public boolean mouseMove(Event event,
                           int x,
                           int y)

Overrides:

mouseMove in class Component

  public Image snapshot()

  public void exportAsGIF(OutputStream os) throws IOException

  public void addChartLabel(JCChartLabel label)

  public void removeChartLabel(JCChartLabel label)

All Packages  Class Hierarchy  This Package  Previous  Next  Index