edu.hws.jcm.functions
Class TableFunctionInput

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Panel
                    |
                    +--edu.hws.jcm.functions.TableFunctionInput

All Implemented Interfaces:

javax.accessibility.Accessible, java.awt.event.ActionListener, java.util.EventListener, java.awt.image.ImageObserver, java.awt.event.ItemListener, java.awt.MenuContainer, java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.io.Serializable

public class TableFunctionInput

extends java.awt.Panel

implements java.awt.event.ItemListener, java.awt.event.ActionListener, java.awt.event.MouseListener, java.awt.event.MouseMotionListener

A TableInputFunction is a Panel that can be used to define a TableFunction or to edit an existing TableFunction. To fetch the function currently displayed in the panel, call copyOfCurrentFunction(). To edit a function, call startEdit() to install the function. Then call cancelEdit() or finishEdit() to finish the editing. The panel displays both the graph of the function and a list of points that define the function. The user can drag the points on the graph up and down to change the y-values. Points can be added or modified by typing in their x- and y-coordinates. A point can be deleted by clicking it in the list of points and then clicking on the button labeled "Delete Point".

See Also:

Serialized Form

Inner classes inherited from class java.awt.Panel

java.awt.Panel.AccessibleAWTPanel

Inner classes inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Inner classes inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

TableFunctionInput()
Create a TableFunctionInput panel.

Method Summary

void	actionPerformed(java.awt.event.ActionEvent evt) React when user clicks one of the buttons or presses return in one of the input boxes.
void	cancelEdit() Discards the internal pointer to the edit function (specified by startEdit()), if any.
TableFunction	copyOfCurrentFunction() Create a new TableFunction containing the data that is currently in the TableFunctionInput panel, and return a pointer to that new function.
TableFunction	finishEdit() If an edit function has been specified (by startEdit()), this function copies the data form the TableFunctionInput into that function, and returns a pointer to that function.
java.awt.Insets	getInsets() Leave a 3-pixel gap around the edges of the panel.
Controller	getOnChange() Get the Controller that is notified when the user edits the data in this panel.
void	itemStateChanged(java.awt.event.ItemEvent evt) React when user clicks on a point in the list of points or clicks one of the radio buttons for specifying the style of the function.
void	mouseClicked(java.awt.event.MouseEvent evt) Empty method, required by the MouseListener interface.
void	mouseDragged(java.awt.event.MouseEvent evt) Method required by the MouseListener interface.
void	mouseEntered(java.awt.event.MouseEvent evt) Empty method, required by the MouseMotionListener interface.
void	mouseExited(java.awt.event.MouseEvent evt) Empty method, required by the MouseMotionListener interface.
void	mouseMoved(java.awt.event.MouseEvent evt) Empty method, required by the MouseMotionListener interface.
void	mousePressed(java.awt.event.MouseEvent evt) Method required by the MouseListener interface.
void	mouseReleased(java.awt.event.MouseEvent evt) Method required by the MouseListener interface.
void	revertEditFunction() If a function has been specified using startEdit(), and neither finishEdit() nor cancelEdit have been called, then this method will discard the current data in and replace it with data from the edit function.
void	setOnChange(Controller c) Specify a controller whose compute() method will be called whenever the user edits the data in this TableFunctionInput panel.
void	startEdit(TableFunction f) Install a function to be edited.

Methods inherited from class java.awt.Panel

addNotify, getAccessibleContext

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, getListeners, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setFont, setLayout, update, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, isLightweight, isOpaque, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TableFunctionInput

public TableFunctionInput()

Create a TableFunctionInput panel. Initially, the function in the panel has no points and so is undefined everywhere. The panel needs to be fairly large!

Method Detail

startEdit

public void startEdit(TableFunction f)

Install a function to be edited. The data from the function is copied into the panel, and a pointer to the function is retained. Note that the function itself is not changed by any editing that the user does. To commit the changes made by the user to the actual function, you must call finishEdit(). If f is null, the effect is to start with a new, empty function.

revertEditFunction

public void revertEditFunction()

If a function has been specified using startEdit(), and neither finishEdit() nor cancelEdit have been called, then this method will discard the current data in and replace it with data from the edit function. If there is no edit function, then the data is simply discarded. (That is, the data reverts to an empty point list.)

finishEdit

public TableFunction finishEdit()

If an edit function has been specified (by startEdit()), this function copies the data form the TableFunctionInput into that function, and returns a pointer to that function. This ends the edit session, and the internally stored pointer to the edit function is discarded. If no edit function has been specified then a new TableFunction is created with the data from the panel, and a pointer to the new function is returned. This does not clear the data in the TableFunctionInput panel.

cancelEdit

public void cancelEdit()

Discards the internal pointer to the edit function (specified by startEdit()), if any. This does not clear the data in the TableFunctionInput panel.

copyOfCurrentFunction

public TableFunction copyOfCurrentFunction()

Create a new TableFunction containing the data that is currently in the TableFunctionInput panel, and return a pointer to that new function.

setOnChange

public void setOnChange(Controller c)

Specify a controller whose compute() method will be called whenever the user edits the data in this TableFunctionInput panel. (Note that when the user edits the function by dragging a point, the Controller is only called once at the end of the drag.) If the specified Controller is null, then no notification takes place.

getOnChange

public Controller getOnChange()

Get the Controller that is notified when the user edits the data in this panel. The return value can be null (the default), indicating that no notification takes place.

getInsets

public java.awt.Insets getInsets()

Leave a 3-pixel gap around the edges of the panel. Not meant to be called directly.

Overrides:

getInsets in class java.awt.Container

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent evt)

React when user clicks one of the buttons or presses return in one of the input boxes. Not meant to be called directly.

Specified by:

actionPerformed in interface java.awt.event.ActionListener

itemStateChanged

public void itemStateChanged(java.awt.event.ItemEvent evt)

React when user clicks on a point in the list of points or clicks one of the radio buttons for specifying the style of the function. Not meant to be called directly.

Specified by:

itemStateChanged in interface java.awt.event.ItemListener

mousePressed

public void mousePressed(java.awt.event.MouseEvent evt)

Method required by the MouseListener interface. Defined here to support dragging of points on the function's graph. Not meant to be called directly.

Specified by:

mousePressed in interface java.awt.event.MouseListener

mouseReleased

public void mouseReleased(java.awt.event.MouseEvent evt)

Method required by the MouseListener interface. Defined here to support dragging of points on the function's graph. Not meant to be called directly.

Specified by:

mouseReleased in interface java.awt.event.MouseListener

mouseDragged

public void mouseDragged(java.awt.event.MouseEvent evt)

Method required by the MouseListener interface. Defined here to support dragging of points on the function's graph. Not meant to be called directly.

Specified by:

mouseDragged in interface java.awt.event.MouseMotionListener

mouseClicked

public void mouseClicked(java.awt.event.MouseEvent evt)

Empty method, required by the MouseListener interface.

Specified by:

mouseClicked in interface java.awt.event.MouseListener

mouseEntered

public void mouseEntered(java.awt.event.MouseEvent evt)

Empty method, required by the MouseMotionListener interface.

Specified by:

mouseEntered in interface java.awt.event.MouseListener

mouseExited

public void mouseExited(java.awt.event.MouseEvent evt)

Empty method, required by the MouseMotionListener interface.

Specified by:

mouseExited in interface java.awt.event.MouseListener

mouseMoved

public void mouseMoved(java.awt.event.MouseEvent evt)

Empty method, required by the MouseMotionListener interface.

Specified by:

mouseMoved in interface java.awt.event.MouseMotionListener