Class PopupDialogQuery

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Dialog
                          |
                          +--PopupDialogQuery

All Implemented Interfaces:

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

class PopupDialogQuery

extends java.awt.Dialog

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

The class is a generic popup query dialog window used throughout MAExplorer. It displays a dialog window containing a editable TextField. There are also 2 buttons ("Ok" and "Cancel") to pass the infomormation on. If you have one button the label is "Continue".

This work was produced by Peter Lemkin of the National Cancer Institute, an agency of the United States Government. As a work of the United States Government there is no associated copyright. It is offered as open source software under the Mozilla Public License (version 1.1) subject to the limitations noted in the accompanying LEGAL file. This notice must be included with the code. The MAExplorer Mozilla and Legal files are available on http://maexplorer.sourceforge.net/.

Version:

$Date: 2002/12/04 20:45:13 $ $Revision: $

Author:

P. Lemkin (NCI), G. Thornwall (SAIC), NCI-Frederick, Frederick, MD

See Also:

MAExplorer Home, Serialized Form

Inner classes inherited from class java.awt.Dialog

java.awt.Dialog.AccessibleAWTDialog

Inner classes inherited from class java.awt.Window

java.awt.Window.AccessibleAWTWindow

Inner classes inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Inner classes inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.AWTTreeLock

Field Summary

private int	addButtonsCnt # of buttons to add.
(package private) boolean	alertDone button pressed flag
(package private) int	colSize # of columns to display
(package private) java.lang.String	data for returning data back to MAE
(package private) static int	DEF_COL_SIZE default # of columns
(package private) java.awt.Frame	frame popup frame instance
(package private) int	height size of frame
private java.awt.Label	label for data label
(package private) java.awt.event.ActionListener	listener Tried this instead of "this"
private MAExplorer	mae link to global instance to MAExplorer
(package private) int	nOptions optionValues[0:nOptions]
private java.awt.Choice	optionChoice opt.
private java.awt.Panel	optionPanel for options
(package private) java.lang.String[]	optionValues list of option values if present
(package private) boolean	sleepFlag wait for button to be pushed
private java.lang.String	spaces DEF_COL_SIZE spaces
(package private) java.awt.TextField	textField place text to be edited here
(package private) int	width size of frame

Fields inherited from class java.awt.Dialog

base, keepBlocking, modal, nameCounter, resizable, serialVersionUID, title

Fields inherited from class java.awt.Window

active, dbg, focusMgr, inputContext, inputContextLock, OPENED, ownedWindowList, showWithParent, state, warningString, weakThis, windowListener, windowSerializedDataVersion

Fields inherited from class java.awt.Container

component, containerListener, containerSerializedDataVersion, dispatcher, layoutMgr, listeningBoundsChildren, listeningChildren, maxSize, ncomponents, printing, printingThreads

Fields inherited from class java.awt.Component

accessibleContext, actionListenerK, adjustmentListenerK, appContext, background, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, changeSupport, componentListener, componentListenerK, componentOrientation, componentSerializedDataVersion, containerListenerK, cursor, dropTarget, enabled, eventMask, focusListener, focusListenerK, font, foreground, graphicsConfig, hasFocus, hierarchyBoundsListener, hierarchyBoundsListenerK, hierarchyListener, hierarchyListenerK, incRate, inputMethodListener, inputMethodListenerK, isInc, isPacked, itemListenerK, keyListener, keyListenerK, LEFT_ALIGNMENT, locale, LOCK, metrics, minSize, mouseListener, mouseListenerK, mouseMotionListener, mouseMotionListenerK, name, nameExplicitlySet, newEventsOnly, ownedWindowK, parent, peer, peerFont, popups, prefSize, privateKey, RIGHT_ALIGNMENT, textListenerK, TOP_ALIGNMENT, valid, visible, windowClosingException, windowListenerK, x, y

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

(package private)

PopupDialogQuery(MAExplorer mae, java.awt.Frame f, int addButtonsCnt) PopupDialogQuery() - Constructor

Method Summary

void	actionPerformed(java.awt.event.ActionEvent e) actionPerformed() - Handle button clicks
(package private) void	alertTimeout(java.lang.String msg) alertTimeout() - update the popup dialog msg - wait for "Continue"
(package private) float	dialogQuery(java.lang.String msg, float defaultValue) dialogQuery() - query float variable
(package private) int	dialogQuery(java.lang.String msg, int defaultValue) dialogQuery() - query int variable
(package private) java.lang.String	dialogQuery(java.lang.String msg, java.lang.String defaultValue) dialogQuery() - query String variable requested
(package private) java.lang.String	dialogQuery(java.lang.String msg, java.lang.String defaultValue, java.lang.String[] optionValues, int nOptions) dialogQuery() - query String variable int requested
void	itemStateChanged(java.awt.event.ItemEvent e) itemStateChanged() - event handler for Choices
(package private) void	startPopupDialog(java.lang.String windowTitle, int colSize) startPopupDialog() - create a hidden dialog panel within a frame.
(package private) void	updatePopupDialog(java.lang.String defaultDataMsg, java.lang.String defaultData, java.lang.String[] optionValues, int nOptions) updatePopupDialog() - display/unhide popup dialog frame and set new values.
void	windowActivated(java.awt.event.WindowEvent e)
void	windowClosed(java.awt.event.WindowEvent e)
void	windowClosing(java.awt.event.WindowEvent e) windowClosing() - close down the window on PC only.
void	windowDeactivated(java.awt.event.WindowEvent e)
void	windowDeiconified(java.awt.event.WindowEvent e)
void	windowIconified(java.awt.event.WindowEvent e)
void	windowOpened(java.awt.event.WindowEvent e)

Methods inherited from class java.awt.Dialog

, addNotify, conditionalShow, constructComponentName, dispose, disposeImpl, getAccessibleContext, getTitle, hide, hideAndDisposeHandler, initIDs, interruptBlocking, isModal, isResizable, paramString, setModal, setResizable, setTitle, show

Methods inherited from class java.awt.Window

addOwnedWindow, addWindowListener, adjustListeningChildren, applyResourceBundle, applyResourceBundle, connectOwnedWindow, dispatchEventImpl, eventEnabled, finalize, getFocusOwner, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getOwnedWindows, getOwner, getToolkit, getWarningString, isActive, isShowing, nextFocus, ownedInit, pack, postEvent, postProcessKeyEvent, postWindowEvent, preProcessKeyEvent, processEvent, processWindowEvent, readObject, removeOwnedWindow, removeWindowListener, resetGC, setCursor, setFocusOwner, setWarningString, toBack, toFront, transferFocus, writeObject

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, applyOrientation, checkGD, countComponents, createChildHierarchyEvents, createHierarchyEvents, deliverEvent, dispatchEventToSelf, doLayout, findComponentAt, findComponentAt, findComponentAt, getAccessibleAt, getAccessibleChild, getAccessibleChildrenCount, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents_NoClientCode, getComponents, getInsets, getLayout, getMaximumSize, getMinimumSize, getMouseEventTarget, getPreferredSize, getWindow, insets, invalidate, invalidateTree, isAncestorOf, layout, lightweightPaint, lightweightPrint, list, list, locate, minimumSize, numListening, paint, paintComponents, paintHeavyweightComponents, postsOldMouseEvents, preferredSize, print, printComponents, printHeavyweightComponents, processContainerEvent, proxyEnableEvents, proxyRequestFocus, remove, remove, removeAll, removeContainerListener, removeNotify, setFont, setLayout, update, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, areInputMethodsEnabled, bounds, checkImage, checkImage, checkWindowClosingException, coalesceEvents, contains, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getAccessibleIndexInParent, getAccessibleStateSet, getBackground, getBounds, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont_NoClientCode, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputMethodRequests, getLocation, getLocation, getLocationOnScreen_NoTreeLock, getLocationOnScreen, getName, getNativeContainer, getParent_NoClientCode, getParent, getPeer, getSize, getSize, getToolkitImpl, getTreeLock, getWidth, getWindowForObject, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isDisplayable, isDoubleBuffered, isEnabled, isEnabledImpl, isFocusTraversable, isLightweight, isOpaque, isRecursivelyVisible, 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, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setDropTarget, setEnabled, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, size, toString, transferFocus

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, registerNatives, wait, wait, wait

Field Detail

mae

private MAExplorer mae

link to global instance to MAExplorer

DEF_COL_SIZE

static final int DEF_COL_SIZE

default # of columns

data

java.lang.String data

for returning data back to MAE

colSize

int colSize

# of columns to display

width

int width

size of frame

height

int height

size of frame

frame

java.awt.Frame frame

popup frame instance

textField

java.awt.TextField textField

place text to be edited here

label

private java.awt.Label label

for data label

optionPanel

private java.awt.Panel optionPanel

for options

optionChoice

private java.awt.Choice optionChoice

opt. option choice list

addButtonsCnt

private int addButtonsCnt

# of buttons to add. if 0, then none, if 1, then add CONTINUE, if 2 then add OK and CANCEL.

alertDone

boolean alertDone

button pressed flag

sleepFlag

boolean sleepFlag

wait for button to be pushed

listener

java.awt.event.ActionListener listener

Tried this instead of "this"

spaces

private java.lang.String spaces

DEF_COL_SIZE spaces

optionValues

java.lang.String[] optionValues

list of option values if present

nOptions

int nOptions

optionValues[0:nOptions]

Constructor Detail

PopupDialogQuery

PopupDialogQuery(MAExplorer mae,
                 java.awt.Frame f,
                 int addButtonsCnt)

PopupDialogQuery() - Constructor

Parameters:

mae - is instance of MAExplorer

f - is frame of parent

addButtonsCnt - is # of buttons to use where: 1 is (OK), 2 is (Continue, Cancel), 3 is OptionsChoice & (Continue, Cancel)

See Also:

startPopupDialog(java.lang.String, int)

Method Detail

startPopupDialog

void startPopupDialog(java.lang.String windowTitle,
                      int colSize)

startPopupDialog() - create a hidden dialog panel within a frame.

Parameters:

windowTitle - is the title of the dialog window

colSize - is the size of the textField

updatePopupDialog

void updatePopupDialog(java.lang.String defaultDataMsg,
                       java.lang.String defaultData,
                       java.lang.String[] optionValues,
                       int nOptions)

updatePopupDialog() - display/unhide popup dialog frame and set new values. Remove recreate actionListeners & components.

Parameters:

defaultDataMsg - is the label for textField

defaultDatais - the data for textField

optionValues - is the list of option values

nOptions - is the number of options

alertTimeout

void alertTimeout(java.lang.String msg)

alertTimeout() - update the popup dialog msg - wait for "Continue"

Parameters:

msg - is message to display

See Also:

updatePopupDialog(java.lang.String, java.lang.String, java.lang.String[], int)

actionPerformed

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

actionPerformed() - Handle button clicks

Specified by:

actionPerformed in interface java.awt.event.ActionListener

Parameters:

e - is action event when button pressed

itemStateChanged

public void itemStateChanged(java.awt.event.ItemEvent e)

itemStateChanged() - event handler for Choices

Specified by:

itemStateChanged in interface java.awt.event.ItemListener

Parameters:

e - is item event when choices selected

See Also:

Component.repaint()

windowClosing

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

windowClosing() - close down the window on PC only.

Specified by:

windowClosing in interface java.awt.event.WindowListener

Parameters:

e - is window closing event

dialogQuery

int dialogQuery(java.lang.String msg,
                int defaultValue)

dialogQuery() - query int variable

Parameters:

msg - is message to display in dialog box

defaultValue - to use

See Also:

Util.cvs2i(java.lang.String), updatePopupDialog(java.lang.String, java.lang.String, java.lang.String[], int)

dialogQuery

float dialogQuery(java.lang.String msg,
                  float defaultValue)

dialogQuery() - query float variable

Parameters:

msg - is message to display in dialog box

defaultValue - to use

See Also:

Util.cvs2f(java.lang.String), updatePopupDialog(java.lang.String, java.lang.String, java.lang.String[], int)

dialogQuery

java.lang.String dialogQuery(java.lang.String msg,
                             java.lang.String defaultValue)

dialogQuery() - query String variable requested

Parameters:

msg - is message to display in dialog box

defaultValue - to use if press OK and there is no data

See Also:

updatePopupDialog(java.lang.String, java.lang.String, java.lang.String[], int)

dialogQuery

java.lang.String dialogQuery(java.lang.String msg,
                             java.lang.String defaultValue,
                             java.lang.String[] optionValues,
                             int nOptions)

dialogQuery() - query String variable int requested

Parameters:

msg - is message to display in dialog box

defaultValue - to use

optionValues - to use

nOptions - number of option values

See Also:

updatePopupDialog(java.lang.String, java.lang.String, java.lang.String[], int)

windowOpened

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

Specified by:

windowOpened in interface java.awt.event.WindowListener

windowActivated

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

Specified by:

windowActivated in interface java.awt.event.WindowListener

windowClosed

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

Specified by:

windowClosed in interface java.awt.event.WindowListener

windowDeactivated

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

Specified by:

windowDeactivated in interface java.awt.event.WindowListener

windowDeiconified

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

Specified by:

windowDeiconified in interface java.awt.event.WindowListener

windowIconified

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

Specified by:

windowIconified in interface java.awt.event.WindowListener