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, KeyListener, MouseListener, MouseMotionListener, TimerListener

AREA

BAR

browser

CANDLE

current

expiry

FILLED_RADAR

HILO

HILO_OPEN_CLOSE

NONE

os

PIE

PLOT

POLAR

RADAR

SCATTER_PLOT

STACKING_BAR

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)

Creates a new data view and added it to the chart at the specified index.

addNotify()

addPickListener(JCPickListener)

addTrigger()

Adds a new event trigger to the Triggers property.

cancel()

Performs a cancel on the chart.

expired()

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.

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.

keyDown(Event, int)

keyDown() provides default JDK 1.0.2 functionality Called by keyPressed() under JDK 1.1.1

keyPressed(KeyEvent)

keyReleased(KeyEvent)

keyTyped(KeyEvent)

layout()

JCChart layout method.

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.

mouseDrag(Event, int, int)

mouseDrag() provides default JDK 1.0.2 functionality Called by mouseDragged() under JDK 1.1.1

mouseDragged(MouseEvent)

mouseEntered(MouseEvent)

mouseExit(Event, int, int)

mouseExit() provides default JDK 1.0.2 functionality Called by mouseExited() under JDK 1.1.1

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)

Disables double-buffering, and calls Container.printAll

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.

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()

timerExpired(Timer)

Implement the TimerListener interface.

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 static final int NONE

 public static final int PLOT

 public static final int SCATTER_PLOT

 public static final int POLAR

 public static final int RADAR

 public static final int FILLED_RADAR

 public static final int HILO

 public static final int HILO_OPEN_CLOSE

 public static final int CANDLE

 public static final int AREA

 public static final int BAR

 public static final int STACKING_BAR

 public static final int PIE

 public static final Date expiry

 public static final Date current

 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 static final boolean expired()

 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)

 public void keyTyped(KeyEvent event)

 public void keyPressed(KeyEvent event)

 public void keyReleased(KeyEvent 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)

Disables double-buffering, and calls Container.printAll

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)

Creates a new data view and added it to the chart at the specified index. Relies on setDataView, so look there for additional information

 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.

 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 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 boolean mouseDrag(Event event,
                          int x,
                          int y)

mouseDrag() provides default JDK 1.0.2 functionality Called by mouseDragged() under JDK 1.1.1

Overrides:

mouseDrag in class Component

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

mouseExit() provides default JDK 1.0.2 functionality Called by mouseExited() under JDK 1.1.1

Overrides:

mouseExit in class Component

 public boolean keyDown(Event evt,
                        int key)

keyDown() provides default JDK 1.0.2 functionality Called by keyPressed() under JDK 1.1.1

Overrides:

keyDown 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 void timerExpired(Timer t)

Implement the TimerListener interface. This method will be called after when a dwell label has a delay specified. Determine if the mouse is still at the same DataIndex that it was when the Timer was set, and show the label if it is.

 public Image snapshot()

 public void addChartLabel(JCChartLabel label)

 public void removeChartLabel(JCChartLabel label)

 public void addNotify()

Overrides:

addNotify in class JCContainer

All Packages  Class Hierarchy  This Package  Previous  Next  Index