g2d.mwa

Class MWAControl

java.lang.Object

g2d.mwa.MWAControl

public final class MWAControl
extends java.lang.Object

Application control for a Multi-Window Application (MWA). Once the last window under this control closes and removes itself from the control listeners, System.exit(0) will be called to exit the JVM.

Implemented as a singleton class.

Author:

Linda, Ian genericized it in January 2007, & added the tree manager in January 2009.

Method Summary

Modifier and Type	Method and Description
void	addControlListener(ControlListener listener) Adds given listeners to set of control listeners to be notified upon change.
protected void	addMWAFrame(MWAFrame childFrame)
protected void	buildWindowsMenu(MWAFrame owner)
protected void	buildWindowsMenu(MWAFrame owner, boolean tilings)
void	closeAll() Advise all controlled frames to close (will exit the JVM because of side effect in removeControlListener(g2d.mwa.ControlListener)).
void	frameHidden(MWAFrame frame)
void	frameShown(MWAFrame frame, MWAFrame parent)
void	frameTitleChanged()
static MWAControl	getInstance() Obtains singleton instance of application control.
static javax.swing.JTree	getTree() Obtains singleton instance of application control's tree manager.
static javax.swing.JFrame	getTreeJFrame()
void	removeControlListener(ControlListener listener) Removes given listeners from set of control listeners to be notified upon change.
protected void	removeMWAFrame(MWAFrame childFrame)

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static MWAControl getInstance()

Obtains singleton instance of application control.

Returns:

singleton instance of application control

getTree

public static javax.swing.JTree getTree()

Obtains singleton instance of application control's tree manager. The tree manager provides some control over the window hierarchy via clicking and shift-clicking on a JTree representation of the hierarchy.

Returns:

singleton instance of application control's JTree window manager.

See Also:

JTree

getTreeJFrame

public static javax.swing.JFrame getTreeJFrame()

addMWAFrame

protected void addMWAFrame(MWAFrame childFrame)

removeMWAFrame

protected void removeMWAFrame(MWAFrame childFrame)

frameShown

public void frameShown(MWAFrame frame,
                       MWAFrame parent)

frameHidden

public void frameHidden(MWAFrame frame)

frameTitleChanged

public void frameTitleChanged()

addControlListener

public void addControlListener(ControlListener listener)

Adds given listeners to set of control listeners to be notified upon change.

Parameters:

listener - ControlListener to be added

removeControlListener

public void removeControlListener(ControlListener listener)

Removes given listeners from set of control listeners to be notified upon change.

As a side effect, once the last listener has de-registered and the set is empty, this will exit the JVM with status 0.

Parameters:

listener - ControlListener to be removed

closeAll

public void closeAll()

Advise all controlled frames to close (will exit the JVM because of side effect in removeControlListener(g2d.mwa.ControlListener)).

buildWindowsMenu

protected void buildWindowsMenu(MWAFrame owner)

buildWindowsMenu

protected void buildWindowsMenu(MWAFrame owner,
                                boolean tilings)