arlut.csd.JDialog
Class StringDialog

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Dialog
                          |
                          +--javax.swing.JDialog
                                |
                                +--arlut.csd.JDialog.JCenterDialog
                                      |
                                      +--arlut.csd.JDialog.StringDialog

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, java.awt.event.WindowListener

public class StringDialog

extends JCenterDialog

implements java.awt.event.ActionListener, java.awt.event.WindowListener

A simple customizable dialog with support for a variety of data field components.

For simple dialogs, use the included constructors. For more complicated dialogs, including check boxes, choice lists, and text fields, use a DialogRsrc object to pass in a pre-defined dialog definition.

The ShowDialog method shows the current dialog, and returns a Hashtable of results, which map the label used in the dialog for individual data fields with the value entered into that field.

See Also:

DialogRsrc, Serialized Form

Field Summary

(package private) javax.swing.JPanel	buttonPanel
(package private) javax.swing.JButton	CancelButton
(package private) java.awt.GridBagConstraints	compgbc
(package private) java.awt.GridBagLayout	compgbl
(package private) java.util.Hashtable	componentHash
(package private) java.util.Vector	components
(package private) javax.swing.JPanel	dataPanel
(package private) static boolean	debug
(package private) boolean	done
(package private) java.awt.GridBagConstraints	gbc
(package private) java.awt.GridBagLayout	gbl
(package private) java.awt.Image	image
(package private) javax.swing.JLabel	imageCanvas
(package private) javax.swing.JPanel	mainPanel
(package private) java.util.Vector	objects
(package private) javax.swing.JButton	OKButton
(package private) javax.swing.JPanel	panel
(package private) arlut.csd.JDataComponent.JMultiLineLabel	textLabel
(package private) java.util.Hashtable	valueHash

Fields inherited from class arlut.csd.JDialog.JCenterDialog

frame

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

StringDialog(arlut.csd.JDialog.DialogRsrc Resource)
Constructor for more complicated StringDialog.

StringDialog(java.awt.Frame frame, java.lang.String Title, java.lang.String Text)
Simple constructor for a small dialog box with a Cancel button

StringDialog(java.awt.Frame frame, java.lang.String Title, java.lang.String Text, boolean ShowCancel)
Simple constructor for a small dialog box

StringDialog(java.awt.Frame frame, java.lang.String Title, java.lang.String Text, java.lang.String OK, java.lang.String Cancel)
Simple constructor for a small dialog box

StringDialog(java.awt.Frame frame, java.lang.String Title, java.lang.String Text, java.lang.String OK, java.lang.String Cancel, java.awt.Image image)
Simple constructor for a small dialog box

Method Summary

void	actionPerformed(java.awt.event.ActionEvent e) Handle the ok and cancel buttons.
private void	addRow(javax.swing.JPanel parent, javax.swing.JComponent comp, java.lang.String label, int row) Convenience method to add a GUI component to this dialog.
java.util.Hashtable	DialogShow() Display the dialog box, locks this thread while the dialog is being displayed, and returns a hashtable of data field values when the user closes the dialog box.
private void	loadValueHash() This method is responsible for scanning all of the input fields in this dialog and loading their values into valueHash for DialogShow() to return.
protected void	registerCallbacks() We want to make it so that when the user hits enter on the last string or password field in the dialog, the ok button is clicked.
void	windowActivated(java.awt.event.WindowEvent event)
void	windowClosed(java.awt.event.WindowEvent event)
void	windowClosing(java.awt.event.WindowEvent event)
void	windowDeactivated(java.awt.event.WindowEvent event)
void	windowDeiconified(java.awt.event.WindowEvent event)
void	windowIconified(java.awt.event.WindowEvent event)
void	windowOpened(java.awt.event.WindowEvent event)

Methods inherited from class arlut.csd.JDialog.JCenterDialog

pack, pack

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, 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

Field Detail

debug

static final boolean debug

See Also:

Constant Field Values

componentHash

java.util.Hashtable componentHash

valueHash

java.util.Hashtable valueHash

done

boolean done

imageCanvas

javax.swing.JLabel imageCanvas

OKButton

javax.swing.JButton OKButton

CancelButton

javax.swing.JButton CancelButton

panel

javax.swing.JPanel panel

mainPanel

javax.swing.JPanel mainPanel

dataPanel

javax.swing.JPanel dataPanel

buttonPanel

javax.swing.JPanel buttonPanel

textLabel

arlut.csd.JDataComponent.JMultiLineLabel textLabel

gbl

java.awt.GridBagLayout gbl

compgbl

java.awt.GridBagLayout compgbl

gbc

java.awt.GridBagConstraints gbc

compgbc

java.awt.GridBagConstraints compgbc

image

java.awt.Image image

objects

java.util.Vector objects

components

java.util.Vector components

Constructor Detail

StringDialog

public StringDialog(java.awt.Frame frame,
                    java.lang.String Title,
                    java.lang.String Text,
                    boolean ShowCancel)

Simple constructor for a small dialog box

Parameters:

frame - Parent frame of the Dialog Box

Title - Title of the Dialog Box

Text - Text shown in the Dialog Box

ShowCancel - if true, show a "Cancel" button

StringDialog

public StringDialog(java.awt.Frame frame,
                    java.lang.String Title,
                    java.lang.String Text)

Simple constructor for a small dialog box with a Cancel button

Parameters:

frame - Parent frame of the Dialog Box

Title - Title of the Dialog Box

Text - Text shown in the Dialog Box

StringDialog

public StringDialog(java.awt.Frame frame,
                    java.lang.String Title,
                    java.lang.String Text,
                    java.lang.String OK,
                    java.lang.String Cancel)

Simple constructor for a small dialog box

Parameters:

frame - Parent frame of the Dialog Box

Title - Title of the Dialog Box

Text - Text shown in the Dialog Box

OK - String for "OK" button

Cancel - String for "Cancel" button

StringDialog

public StringDialog(java.awt.Frame frame,
                    java.lang.String Title,
                    java.lang.String Text,
                    java.lang.String OK,
                    java.lang.String Cancel,
                    java.awt.Image image)

Simple constructor for a small dialog box

Parameters:

frame - Parent frame of the Dialog Box

Title - Title of the Dialog Box

Text - Text shown in the Dialog Box

OK - String for "OK" button

Cancel - String for "Cancel" button

image - Image to display next to text

StringDialog

public StringDialog(arlut.csd.JDialog.DialogRsrc Resource)

Constructor for more complicated StringDialog.

Parameters:

Resource - Sets resource for Dialog box.

Method Detail

registerCallbacks

protected void registerCallbacks()

We want to make it so that when the user hits enter on the last string or password field in the dialog, the ok button is clicked.

DialogShow

public java.util.Hashtable DialogShow()

Display the dialog box, locks this thread while the dialog is being displayed, and returns a hashtable of data field values when the user closes the dialog box.

Use this instead of Dialog.show(). If Hashtable returned is null, then the cancel button was clicked. Otherwise, it will contain a hash of labels(String) to results (Object).

Returns:

HashTable of labels to values

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)

Handle the ok and cancel buttons.

Specified by:

actionPerformed in interface java.awt.event.ActionListener

loadValueHash

private void loadValueHash()

This method is responsible for scanning all of the input fields in this dialog and loading their values into valueHash for DialogShow() to return.

addRow

private final void addRow(javax.swing.JPanel parent,
                          javax.swing.JComponent comp,
                          java.lang.String label,
                          int row)

Convenience method to add a GUI component to this dialog.

windowActivated

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

Specified by:

windowActivated in interface java.awt.event.WindowListener

windowClosed

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

Specified by:

windowClosed in interface java.awt.event.WindowListener

windowClosing

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

Specified by:

windowClosing in interface java.awt.event.WindowListener

windowDeactivated

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

Specified by:

windowDeactivated in interface java.awt.event.WindowListener

windowDeiconified

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

Specified by:

windowDeiconified in interface java.awt.event.WindowListener

windowIconified

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

Specified by:

windowIconified in interface java.awt.event.WindowListener

windowOpened

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

Specified by:

windowOpened in interface java.awt.event.WindowListener