org.gjt.btools.gui.dialog
Class InputBox

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Dialog
                          |
                          +--javax.swing.JDialog
                                |
                                +--org.gjt.btools.gui.dialog.InputBox
All Implemented Interfaces:
javax.accessibility.Accessible, java.awt.event.ActionListener, java.util.EventListener, java.awt.image.ImageObserver, java.awt.MenuContainer, javax.swing.RootPaneContainer, java.io.Serializable, javax.swing.WindowConstants

public class InputBox
extends javax.swing.JDialog
implements java.awt.event.ActionListener

Represents a dialog that asks the user for a simple text string. Note that pressing Return in the dialog will have the same effect as pressing the OK button.

Generally you will never need to create a new dialog; the static member function getInput() will do all the work for you.

See Also:
Serialized Form

Field Summary
 
Fields inherited from class javax.swing.JDialog
accessibleContext, rootPane, rootPaneCheckingEnabled
 
Fields inherited from class java.awt.Dialog
 
Fields inherited from class java.awt.Window
 
Fields inherited from class java.awt.Container
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface javax.swing.WindowConstants
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE
 
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
InputBox(java.awt.Dialog parent, java.lang.String title)
          Create a new input box.
InputBox(java.awt.Dialog parent, java.lang.String title, java.lang.String text)
          Create a new input box.
InputBox(java.awt.Frame parent, java.lang.String title)
          Create a new input box.
InputBox(java.awt.Frame parent, java.lang.String title, java.lang.String text)
          Create a new input box.
 
Method Summary
 void actionPerformed(java.awt.event.ActionEvent e)
          Called when a button is pressed.
static java.lang.String getInput(java.awt.Dialog parent, java.lang.String text)
          Creates and runs a new input box and returns the information collected from the user.
static java.lang.String getInput(java.awt.Dialog parent, java.lang.String title, java.lang.String text)
          Creates and runs a new input box and returns the information collected from the user.
static java.lang.String getInput(java.awt.Frame parent, java.lang.String text)
          Creates and runs a new input box and returns the information collected from the user.
static java.lang.String getInput(java.awt.Frame parent, java.lang.String title, java.lang.String text)
          Creates and runs a new input box and returns the information collected from the user.
 java.lang.String runBox()
          Displays the input box and returns the information collected from the user.
 
Methods inherited from class javax.swing.JDialog
addImpl, createRootPane, dialogInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getJMenuBar, getLayeredPane, getRootPane, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, update
 
Methods inherited from class java.awt.Dialog
addNotify, dispose, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setResizable, setTitle, setUndecorated, show
 
Methods inherited from class java.awt.Window
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, finalize, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, isActive, isFocusableWindow, isFocusCycleRoot, isFocused, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, 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, processContainerEvent, remove, removeAll, removeContainerListener, removeNotify, setFocusTraversalKeys, setFocusTraversalPolicy, setFont, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, 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, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, 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
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

InputBox

public InputBox(java.awt.Frame parent,
                java.lang.String title)
Create a new input box.

Parameters:
parent - the window to use as parent for the new dialog.

InputBox

public InputBox(java.awt.Frame parent,
                java.lang.String title,
                java.lang.String text)
Create a new input box.

Parameters:
parent - the window to use as parent for the new dialog.
title - the title to give the new dialog.
text - the prompt to present to the user.

InputBox

public InputBox(java.awt.Dialog parent,
                java.lang.String title)
Create a new input box.

Parameters:
parent - the window to use as parent for the new dialog.

InputBox

public InputBox(java.awt.Dialog parent,
                java.lang.String title,
                java.lang.String text)
Create a new input box.

Parameters:
parent - the window to use as parent for the new dialog.
title - the title to give the new dialog.
text - the prompt to present to the user.
Method Detail

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)
Called when a button is pressed.

Specified by:
actionPerformed in interface java.awt.event.ActionListener
Parameters:
e - information on the button press event.

runBox

public java.lang.String runBox()
Displays the input box and returns the information collected from the user.

Returns:
the information collected from the user if OK was pressed to close the dialog, or null otherwise.

getInput

public static java.lang.String getInput(java.awt.Frame parent,
                                        java.lang.String text)
Creates and runs a new input box and returns the information collected from the user.

Parameters:
parent - the window to use as parent for the new dialog.
text - the prompt to present to the user.
Returns:
the information collected from the user if OK was pressed to close the dialog, or null otherwise.

getInput

public static java.lang.String getInput(java.awt.Frame parent,
                                        java.lang.String title,
                                        java.lang.String text)
Creates and runs a new input box and returns the information collected from the user.

Parameters:
parent - the window to use as parent for the new dialog.
title - the title to give the new dialog.
text - the prompt to present to the user.
Returns:
the information collected from the user if OK was pressed to close the dialog, or null otherwise.

getInput

public static java.lang.String getInput(java.awt.Dialog parent,
                                        java.lang.String text)
Creates and runs a new input box and returns the information collected from the user.

Parameters:
parent - the window to use as parent for the new dialog.
text - the prompt to present to the user.
Returns:
the information collected from the user if OK was pressed to close the dialog, or null otherwise.

getInput

public static java.lang.String getInput(java.awt.Dialog parent,
                                        java.lang.String title,
                                        java.lang.String text)
Creates and runs a new input box and returns the information collected from the user.

Parameters:
parent - the window to use as parent for the new dialog.
title - the title to give the new dialog.
text - the prompt to present to the user.
Returns:
the information collected from the user if OK was pressed to close the dialog, or null otherwise.


Copyright © 1998-2001, Ben Burton
This software is released under the GNU Public License.
For further information, or to submit a bug or other problem, please contact Ben Burton (bab@debian.org).