uci.gef
Class Globals

java.lang.Object
  |
  +--uci.gef.Globals

public class Globals

extends Object

This class stores global info that is needed by all Editors. For example, it aids in communication between the various Palette's and Editor's by holding the next global Mode.

Field Summary

protected static Applet	_applet
protected static AppletContext	_appletContext
protected static Editor	_curEditor The Editor that most recently contained the mouse.
protected static Mode	_mode The next global mode.
protected static Hashtable	_pcListeners A global dictionary of PropertyChangeListeners for Figs.
protected static Prefs	_prefs The user's preferences for various editor features.
static IStatusBar	_StatusBar The place where status messages will be written.
protected static boolean	_sticky True if the next global Mode should remain as the next global mode even after it has been given to one editor.
protected static MediaTracker	_tracker
static Vector	clipBoard Until jdk 1.2, this will be our clipboard
static String	defaultStatus String to display when nothing important is being displayed.
static String	LastDirectory The directory most recently used in an open or save dialog
static int	MAX_LISTENERS The most listeners a Fig can have, 4.
static String	REMOVE
static boolean	ShowFigTips Determines if tool tips be are shown on Figs in diagrams, including ToDoItem headlines.

Constructor Summary

Globals()

Method Summary

static void	addPropertyChangeListener(Object src, PropertyChangeListener l) Add a listener to a Fig.
static void	clearStatus() Sets the status to its default (blank) string.
static Editor	curEditor() Reply the Editor that most recently contained the mouse.
static void	curEditor(Editor ce) Set the current Editor.
protected static Mode	defaultMode() What mode should Editor's go into if the Palette is not requesting a specific mode?
static void	firePropChange(Object src, String propName, boolean oldV, boolean newV) Send a property change event to listeners of the src Fig.
static void	firePropChange(Object src, String propName, int oldV, int newV) Send a property change event to listeners of the src Fig.
static void	firePropChange(Object src, String propName, Object oldValue, Object newValue) Send a property change event to listeners of the src Fig.
static Applet	getApplet()
static AppletContext	getAppletContext()
static Image	getImage(String urlStr) Get an image from the given URL (usually a gif file).
static Image	getImage(URL url) Get an image from the given URL (usually a gif file).
static String	getLastDirectory()
static Prefs	getPrefs() Reply the user's preferences.
static boolean	getShowFigTips()
static boolean	getSticky()
static Mode	mode() Reply the next global mode.
static void	mode(Mode m) Set the next global mode.
static void	mode(Mode m, boolean s) Set the next global mode, and set it's stickiness.
static Mode	nextMode() Determine the next global mode.
static void	quit() Try to exit the applet or application.
static void	removePropertyChangeListener(Object s, PropertyChangeListener l)
static void	setApplet(Applet a) If we are running as an applet, Store the Applet and AppletContext in a well known place.
static void	setLastDirectory(String s)
static void	setShowFigTips(boolean b)
static void	setStatusBar(IStatusBar sb) Sets the place where status messages will be written.
static void	setSticky(boolean b) Set whether the next global mode should remain as the next global mode even after it has been given to one editor.
static void	showDocument(String urlString) If we are running as an applet, ask the browser to display the given URL.
static void	showDocument(URL url) If we are running as an applet, ask the browser to display the given URL.
static void	showDocument(URL url, String target) If we are running as an applet, ask the browser to display the given URL.
static void	showStatus(String s) Show a string on the some status bar, or print a message on the console.
static Frame	someFrame() Return an exisiting instance of class Frame.
static void	startPropertySheet() Open the property sheet.
static void	waitForImages() Wait for all images to download.

Methods inherited from class java.lang.Object

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

Field Detail

REMOVE

public static final String REMOVE

_appletContext

protected static AppletContext _appletContext

_applet

protected static Applet _applet

_tracker

protected static MediaTracker _tracker

defaultStatus

public static String defaultStatus

String to display when nothing important is being displayed. By default the string " " is used. Some applications may want to change this to "Ready." It should not be set to "", because that can mess up window layouts, causing the status line to disappear.

clipBoard

public static Vector clipBoard

Until jdk 1.2, this will be our clipboard

LastDirectory

public static String LastDirectory

The directory most recently used in an open or save dialog

ShowFigTips

public static boolean ShowFigTips

Determines if tool tips be are shown on Figs in diagrams, including ToDoItem headlines.

_StatusBar

public static IStatusBar _StatusBar

The place where status messages will be written.

_prefs

protected static Prefs _prefs

The user's preferences for various editor features.

_sticky

protected static boolean _sticky

True if the next global Mode should remain as the next global mode even after it has been given to one editor.

_mode

protected static Mode _mode

The next global mode. This is given to an editor on mouse entry

_curEditor

protected static Editor _curEditor

The Editor that most recently contained the mouse.

_pcListeners

protected static Hashtable _pcListeners

A global dictionary of PropertyChangeListeners for Figs. Most Figs will not have any listeners at any given moment, so I did not want to allocate an instance variable to hold listeners. Instead I use this global Hashtable with Figs ans keys and arrays of up to 4 listeners as values.

Note: It is important that all listeners eventually remove themselves by calling removePropertyChangeListener. Otherwise this table will keep pointers that can reduce grabage collection.

MAX_LISTENERS

public static int MAX_LISTENERS

The most listeners a Fig can have, 4.

Constructor Detail

Globals

public Globals()

Method Detail

setApplet

public static void setApplet(Applet a)

If we are running as an applet, Store the Applet and AppletContext in a well known place.

getAppletContext

public static AppletContext getAppletContext()

getApplet

public static Applet getApplet()

getLastDirectory

public static String getLastDirectory()

setLastDirectory

public static void setLastDirectory(String s)

getShowFigTips

public static boolean getShowFigTips()

setShowFigTips

public static void setShowFigTips(boolean b)

setStatusBar

public static void setStatusBar(IStatusBar sb)

Sets the place where status messages will be written.

showStatus

public static void showStatus(String s)

Show a string on the some status bar, or print a message on the console.

clearStatus

public static void clearStatus()

Sets the status to its default (blank) string.

showDocument

public static void showDocument(URL url)

If we are running as an applet, ask the browser to display the given URL.

showDocument

public static void showDocument(URL url,
                                String target)

If we are running as an applet, ask the browser to display the given URL.

showDocument

public static void showDocument(String urlString)

If we are running as an applet, ask the browser to display the given URL.

getImage

public static Image getImage(URL url)

Get an image from the given URL (usually a gif file).

getImage

public static Image getImage(String urlStr)

Get an image from the given URL (usually a gif file).

waitForImages

public static void waitForImages()

Wait for all images to download.

quit

public static void quit()

Try to exit the applet or application. Needs-more-work: in the case of an applet, not all windows are closed.

getPrefs

public static Prefs getPrefs()

Reply the user's preferences.

startPropertySheet

public static void startPropertySheet()

Open the property sheet.

someFrame

public static Frame someFrame()

Return an exisiting instance of class Frame. This is needed to create off-screen bit-maps. Needs-more-work: I think Swing keeps its own.

setSticky

public static void setSticky(boolean b)

Set whether the next global mode should remain as the next global mode even after it has been given to one editor.

getSticky

public static boolean getSticky()

defaultMode

protected static Mode defaultMode()

What mode should Editor's go into if the Palette is not requesting a specific mode?

mode

public static void mode(Mode m)

Set the next global mode.

mode

public static void mode(Mode m,
                        boolean s)

Set the next global mode, and set it's stickiness.

mode

public static Mode mode()

Reply the next global mode.

nextMode

public static Mode nextMode()

Determine the next global mode. This is called when a mode finishes whatever it was meant to accomplish. If the sticky flag is set, the current mode stays the next global mode. Otherwise the defaultMode becomes the next global mode.

See Also:

Mode.done()

curEditor

public static void curEditor(Editor ce)

Set the current Editor.

curEditor

public static Editor curEditor()

Reply the Editor that most recently contained the mouse.

addPropertyChangeListener

public static void addPropertyChangeListener(Object src,
                                             PropertyChangeListener l)

Add a listener to a Fig. Now the listener will get notifications of all property change events from that Fig.

removePropertyChangeListener

public static void removePropertyChangeListener(Object s,
                                                PropertyChangeListener l)

firePropChange

public static void firePropChange(Object src,
                                  String propName,
                                  boolean oldV,
                                  boolean newV)

Send a property change event to listeners of the src Fig.

firePropChange

public static void firePropChange(Object src,
                                  String propName,
                                  int oldV,
                                  int newV)

Send a property change event to listeners of the src Fig.

firePropChange

public static void firePropChange(Object src,
                                  String propName,
                                  Object oldValue,
                                  Object newValue)

Send a property change event to listeners of the src Fig.