jvx.thirdParty.acmeGui
Class BusyBox

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Dialog
                  jvx.thirdParty.acmeGui.BusyBox

All Implemented Interfaces:

javax.accessibility.Accessible, java.util.EventListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.lang.Runnable, java.io.Serializable, java.awt.event.WindowListener

public class BusyBox

extends java.awt.Dialog

implements java.lang.Runnable, java.awt.event.WindowListener

A busy-box.

Puts up a dialog with a specified message. All user input is locked out. When the program is done with its task, it can unlock things by calling the done() method.

Sample usage:

 BusyBox b = new BusyBox( this, "Sample BusyBox" );
 b.show();
 [your task here]
 b.done();
 

NOTE: do not use this inside an event handler call! With some browsers this will cause a deadlock. Instead, have your event handler start a new thread to run the busy box and task.

Operation can be aborted by clicking on the destroy field of the busy box dialog. The busy box sends an action event to registered action listeners when operation is aborted. This method does not dispose this dialog which still must be done by the calling class. This allows to keep this dialog visible and showing the "Aborting ..." message until all clean-up has been done by the calling class.

Copyright (C)1996,1998 by Jef Poskanzer . All rights reserved.

Visit the ACME Labs Java page for up-to-date versions of this and other fine Java utilities: http://www.acme.com/java/

See Also:

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

BusyBox(java.awt.Frame parent, java.lang.String message)

BusyBox(java.awt.Frame parent, java.lang.String title, java.lang.String message)

Method Summary

void	addActionListener(java.awt.event.ActionListener listener) Action events are sent when a user clicks on Ok or Cancel button, doubleclicks on a model in the model dialog or presses in the textfield of the small info panel.
void	done()
void	removeActionListener(java.awt.event.ActionListener listener) Removes (one occurrence of) a listener from internal list.
void	run()
void	show()
void	windowActivated(java.awt.event.WindowEvent event) Method does nothing.
void	windowClosed(java.awt.event.WindowEvent event) Method does nothing.
void	windowClosing(java.awt.event.WindowEvent event) Send an action event to a listener if user clicks on 'delete'-cross of title bar.
void	windowDeactivated(java.awt.event.WindowEvent event) Method does nothing.
void	windowDeiconified(java.awt.event.WindowEvent event) Method does nothing.
void	windowIconified(java.awt.event.WindowEvent event) Method does nothing.
void	windowOpened(java.awt.event.WindowEvent event) Method does nothing.

Methods inherited from class java.awt.Dialog

addNotify, dispose, getAccessibleContext, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setResizable, setTitle, setUndecorated

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, isActive, isFocusableWindow, isFocusCycleRoot, isFocused, isShowing, pack, postEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationRelativeTo, toBack, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, remove, remove, removeAll, removeContainerListener, removeNotify, setFocusTraversalKeys, setFocusTraversalPolicy, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, 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, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isOpaque, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

BusyBox

public BusyBox(java.awt.Frame parent,
               java.lang.String message)

BusyBox

public BusyBox(java.awt.Frame parent,
               java.lang.String title,
               java.lang.String message)

Method Detail

show

public void show()

run

public void run()

Specified by:

run in interface java.lang.Runnable

done

public void done()

windowOpened

public void windowOpened(java.awt.event.WindowEvent event)

Method does nothing.

Specified by:

windowOpened in interface java.awt.event.WindowListener

windowClosed

public void windowClosed(java.awt.event.WindowEvent event)

Method does nothing.

Specified by:

windowClosed in interface java.awt.event.WindowListener

windowDeiconified

public void windowDeiconified(java.awt.event.WindowEvent event)

Method does nothing.

Specified by:

windowDeiconified in interface java.awt.event.WindowListener

windowIconified

public void windowIconified(java.awt.event.WindowEvent event)

Method does nothing.

Specified by:

windowIconified in interface java.awt.event.WindowListener

windowDeactivated

public void windowDeactivated(java.awt.event.WindowEvent event)

Method does nothing.

Specified by:

windowDeactivated in interface java.awt.event.WindowListener

windowActivated

public void windowActivated(java.awt.event.WindowEvent event)

Method does nothing.

Specified by:

windowActivated in interface java.awt.event.WindowListener

windowClosing

public void windowClosing(java.awt.event.WindowEvent event)

Send an action event to a listener if user clicks on 'delete'-cross of title bar. Note, this method does not dispose this dialog which still must be done by the calling class. This allows to keep this dialog visible and showing the "Aborting.." message until all clean-up has been done by the calling class.

Specified by:

windowClosing in interface java.awt.event.WindowListener

addActionListener

public void addActionListener(java.awt.event.ActionListener listener)

Action events are sent when a user clicks on Ok or Cancel button, doubleclicks on a model in the model dialog or presses in the textfield of the small info panel. The event is sent after the model is loaded.

removeActionListener

public void removeActionListener(java.awt.event.ActionListener listener)

Removes (one occurrence of) a listener from internal list. Registered listeners will be effected by fireAction(ActionEvent).