objectdraw
Class WindowController

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Panel
              java.applet.Applet
                  javax.swing.JApplet
                      objectdraw.Controller
                          objectdraw.WindowController

All Implemented Interfaces:

javax.accessibility.Accessible, java.awt.image.ImageObserver, java.awt.MenuContainer, javax.swing.RootPaneContainer, java.io.Serializable

Direct Known Subclasses:

FrameWindowController

public class WindowController

extends Controller

WindowController is a Swing compatible class designed to be extended to produce programs that handle simple mouse events and draw graphics in a single window on the screen. In a program written by extending this class, the instructions to be executed in response to various mouse events are placed in the bodies of the methods onMousePress, onMouseRelease, onMouseClick, onMouseMove, onMouseDrag, onMouseEnter, and onMouseExit. Each of these methods is passed a Location describing the location of the mouse at the time of the event. As in the Controller class, initialization code can be placed in the body of the definition of a begin method. Throughout the definition of a class that extends WindowController, the name "canvas" can be used to refer to the program's DrawingCanvas.

Version:

1.1.2 released July 2006

See Also:

Controller, FrameWindowController, AWTWindowController, Serialized Form

Field Summary

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

WindowController()

Method Summary

void	begin() Programs written by extending Controller can perform any required initialization by defining a begin method containing the code to perform the initialization steps.
void	onMouseClick(Location point) Invoked when the mouse has been clicked on the WindowController's canvas.
void	onMouseDrag(Location point) Invoked when a mouse button is pressed on the canvas and then dragged.
void	onMouseEnter(Location point) Invoked when the mouse enters the WindowController's canvas.
void	onMouseExit(Location point) Invoked when the mouse exits the the WindowController's canvas.
void	onMouseMove(Location point) Invoked when the mouse button has been moved on the canvas (with no buttons down).
void	onMousePress(Location point) Invoked when a mouse button has been pressed on the WindowController's canvas.
void	onMouseRelease(Location point) Invoked when a mouse button has been released on the WindowController's canvas.

Methods inherited from class objectdraw.Controller

destroy, getAudio, getImage, getTime, getVersion, init, placeInFrame, resize, start, startController, startController, stop

Methods inherited from class javax.swing.JApplet

getAccessibleContext, getContentPane, getGlassPane, getJMenuBar, getLayeredPane, getRootPane, remove, setContentPane, setGlassPane, setJMenuBar, setLayeredPane, setLayout, update

Methods inherited from class java.applet.Applet

getAppletContext, getAppletInfo, getAudioClip, getAudioClip, getCodeBase, getDocumentBase, getImage, getImage, getLocale, getParameter, getParameterInfo, isActive, newAudioClip, play, play, resize, setStub, showStatus

Methods inherited from class java.awt.Panel

addNotify

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, remove, removeAll, removeContainerListener, removeNotify, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFont, transferFocusBackward, transferFocusDownCycle, validate

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, dispatchEvent, enable, enable, enableInputMethods, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, 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, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocusInWindow, reshape, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

WindowController

public WindowController()

Method Detail

begin

public void begin()

Description copied from class: Controller

Programs written by extending Controller can perform any required initialization by defining a begin method containing the code to perform the initialization steps.

Overrides:

begin in class Controller

onMouseClick

public void onMouseClick(Location point)

Invoked when the mouse has been clicked on the WindowController's canvas.

Parameters:

point - the point the mouse clicked on

onMousePress

public void onMousePress(Location point)

Invoked when a mouse button has been pressed on the WindowController's canvas.

Parameters:

point - the point the mouse pressed on

onMouseRelease

public void onMouseRelease(Location point)

Invoked when a mouse button has been released on the WindowController's canvas.

Parameters:

point - the point the mouse released on

onMouseEnter

public void onMouseEnter(Location point)

Invoked when the mouse enters the WindowController's canvas.

Parameters:

point - the point the mouse enters

onMouseExit

public void onMouseExit(Location point)

Invoked when the mouse exits the the WindowController's canvas.

Parameters:

point - the point the mouse exits

onMouseDrag

public void onMouseDrag(Location point)

Invoked when a mouse button is pressed on the canvas and then dragged. Mouse drag events will continue to be delivered to the controller until the mouse button is released (regardless of whether the mouse position is within the bounds of the canvas).

Parameters:

point - the point the mouse drags

onMouseMove

public void onMouseMove(Location point)

Invoked when the mouse button has been moved on the canvas (with no buttons down).

Parameters:

point - the point the mouse moves