Sharkysoft home

lava.gui
Class ButtonQuestion

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Dialog
                          |
                          +--lava.gui.ButtonQuestion
All Implemented Interfaces:
javax.accessibility.Accessible, java.awt.event.ActionListener, java.util.EventListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable

public class ButtonQuestion
extends java.awt.Dialog
implements java.awt.event.ActionListener

Dialog box for asking the user a question.

Details: ButtonQuestion provides a convenient mechanism for constructing dialog boxes that ask the user multiple-choice questions. To use this class, simply create an instance of it and then call the waitForResponse method.

Example: This following program demonstrates the use of this class:

Once a ButtonQuestion has been used to issue a question, it cannot be used again, since the dispose method is called automatically when the user selects one of the answers.

For detailed information on how to control the contents of the question box, see the related class, ButtonQuestionParameters.

Since:
1998.10.11
Version:
1999.05.11
See Also:
ButtonQuestionParameters, 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
 
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
ButtonQuestion(java.awt.Frame frame, ButtonQuestionParameters params)
          Creates a new question box according to the specified criteria.
 
Method Summary
 void actionPerformed(java.awt.event.ActionEvent e)
          Do not call this method.
 int waitForResponse()
          Blocks until the question box has been displayed and the user has answered it.
 
Methods inherited from class java.awt.Dialog
addNotify, dispose, getAccessibleContext, getTitle, hide, isModal, isResizable, paramString, setModal, setResizable, setTitle, show
 
Methods inherited from class java.awt.Window
addWindowListener, applyResourceBundle, applyResourceBundle, finalize, getFocusOwner, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getOwnedWindows, getOwner, getToolkit, getWarningString, isShowing, pack, postEvent, processEvent, processWindowEvent, removeWindowListener, setCursor, toBack, toFront
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, 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, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, 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, 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, wait, wait, wait
 

Constructor Detail

ButtonQuestion

public ButtonQuestion(java.awt.Frame frame,
                      ButtonQuestionParameters params)
Creates a new question box according to the specified criteria.

Details: This constructor creates a new question box according to the criteria indicated in params, an instance of ButtonQuestionParameters. The question box becomes a child of frame.

Parameters:
frame - the parent frame
params - the contents and state of the question box
Since:
1988.10.11
See Also:
ButtonQuestionParameters
Method Detail

waitForResponse

public int waitForResponse()
Blocks until the question box has been displayed and the user has answered it.

Details: waitForResponse blocks (i.e., does not return) until the question box has been displayed and the user has answered it. The return value is index of the answer, as recorded in the ButtonQuestionParameters instance that was used when the ButtonQuestion was created.

Returns:
the index of the answer button pushed by the user
Since:
1988.10.11

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)
Do not call this method.

Details: This method is called by the AWT subsystem when the user pushes one of the question box's answer buttons. Your application should never call this method.

Specified by:
actionPerformed in interface java.awt.event.ActionListener
Parameters:
e - the ActionEvent
Since:
1988.10.11

Sharkysoft home