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 ProtPlot. It displays a dialog window containing a editable TextField. There are also 2 buttons ("Ok" and "Cancel") to pass the information 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.

Version:

$Date: 2002/10/22 19:01:17 $ $Revision $

Author:

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

See Also:

ProtPlot 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
java.lang.String	data for returning data back to prp
(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"
(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
private ProtPlot	prp link to global instance to prpxplorer
(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

PopupDialogQuery(ProtPlot prp, 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"
float	dialogQuery(java.lang.String msg, float defaultValue) dialogQuery() - query float variable
int	dialogQuery(java.lang.String msg, int defaultValue) dialogQuery() - query int variable
java.lang.String	dialogQuery(java.lang.String msg, java.lang.String defaultValue) dialogQuery() - query String variable requested
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
void	startPopupDialog(java.lang.String windowTitle, int colSize) startPopupDialog() - create a hidden dialog panel within a frame.
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

prp

private ProtPlot prp

link to global instance to prpxplorer

DEF_COL_SIZE

static final int DEF_COL_SIZE

default # of columns

data

public java.lang.String data

for returning data back to prp

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

public PopupDialogQuery(ProtPlot prp,
                        java.awt.Frame f,
                        int addButtonsCnt)

PopupDialogQuery() - Constructor

Parameters:

prp - is instance of ProtPlot

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

public 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

public 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

public 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, updatePopupDialog(java.lang.String, java.lang.String, java.lang.String[], int)

dialogQuery

public 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, updatePopupDialog(java.lang.String, java.lang.String, java.lang.String[], int)

dialogQuery

public 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

public 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