proper.gui.core.dialog
Class MessageBox

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Dialog
                  javax.swing.JDialog
                      proper.gui.core.dialog.ProperDialog
                          proper.gui.core.dialog.MessageBox

All Implemented Interfaces:

java.awt.event.ActionListener, java.awt.event.KeyListener, java.awt.event.MouseListener, java.awt.event.WindowListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.RootPaneContainer, javax.swing.WindowConstants

Direct Known Subclasses:

ErrorBox, InformationBox, QuestionBox

public class MessageBox
extends ProperDialog

This class defines a simple MessageBox with optional Icon to be displayed on the left side. The title, the text and the buttons are user-defined. It automatically centers itself based on its parent frame.

Can also be achieved with the following methods from JOptionPane

• showConfirmDialog
• showInputDialog
• showMessageDialog
• showOptionDialog

Version:

$Revision: 1.2 $

Author:

FracPete

See Also:

Serialized Form

Field Summary

static java.lang.String[]	BUTTONS_OK buttons OK
static java.lang.String[]	BUTTONS_OKCANCEL buttons OK/Cancel
static java.lang.String[]	BUTTONS_YESNO buttons Yes/No
static java.lang.String[]	BUTTONS_YESNOCANCEL buttons Yes/No/Cancel
static java.lang.String	ICON_ERROR error icon
static java.lang.String	ICON_INFORMATION information icon
static java.lang.String	ICON_QUESTION question icon

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

Constructor Summary

MessageBox(ProperFrame parent, java.lang.String title, java.lang.String text, java.lang.String[] buttons, java.lang.String icon)
displays a dialog with given title, text and buttons

MessageBox(ProperFrame parent, java.lang.String title, java.lang.String text, java.lang.String[] buttons, java.lang.String icon, int width, int height)
displays a dialog with given title, text and buttons

MessageBox(java.lang.String title, java.lang.String text, java.lang.String[] buttons, java.lang.String icon)
displays a dialog with given title, text and buttons

MessageBox(java.lang.String title, java.lang.String text, java.lang.String[] buttons, java.lang.String icon, int width, int height)
displays a dialog with given title, text and buttons

Method Summary

void	actionPerformed(java.awt.event.ActionEvent e) an action has been invoked
int	getPressedButton() returns the index of the button that was pressed
static void	main(java.lang.String[] args) for testing purposes only
void	show() displays the dialog

Methods inherited from class proper.gui.core.dialog.ProperDialog

approved, close, getParentFrame, keyPressed, keyReleased, keyTyped, mouseClicked, mouseEntered, mouseExited, mousePressed, mouseReleased, refresh, setCenteredLocation, windowActivated, windowClosed, windowClosing, windowDeactivated, windowDeiconified, windowIconified, windowOpened

Methods inherited from class javax.swing.JDialog

getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getJMenuBar, getLayeredPane, getRootPane, isDefaultLookAndFeelDecorated, remove, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, update

Methods inherited from class java.awt.Dialog

addNotify, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setResizable, setTitle, setUndecorated

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, isActive, isAlwaysOnTop, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setAlwaysOnTop, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationByPlatform, 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, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusBackward, transferFocusDownCycle, validate

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, dispatchEvent, enable, enable, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, 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, getMousePosition, 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, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

ICON_INFORMATION

public static final java.lang.String ICON_INFORMATION

information icon

See Also:

Constant Field Values

ICON_QUESTION

public static final java.lang.String ICON_QUESTION

question icon

See Also:

Constant Field Values

ICON_ERROR

public static final java.lang.String ICON_ERROR

error icon

See Also:

Constant Field Values

BUTTONS_YESNO

public static final java.lang.String[] BUTTONS_YESNO

buttons Yes/No

BUTTONS_YESNOCANCEL

public static final java.lang.String[] BUTTONS_YESNOCANCEL

buttons Yes/No/Cancel

BUTTONS_OK

public static final java.lang.String[] BUTTONS_OK

buttons OK

BUTTONS_OKCANCEL

public static final java.lang.String[] BUTTONS_OKCANCEL

buttons OK/Cancel

Constructor Detail

MessageBox

public MessageBox(java.lang.String title,
                  java.lang.String text,
                  java.lang.String[] buttons,
                  java.lang.String icon)

displays a dialog with given title, text and buttons

Parameters:

title - the title of the message box

text - the text to display

buttons - the captions of the buttons to display

icon - name/path of icon to display on the left side

MessageBox

public MessageBox(ProperFrame parent,
                  java.lang.String title,
                  java.lang.String text,
                  java.lang.String[] buttons,
                  java.lang.String icon)

displays a dialog with given title, text and buttons

Parameters:

parent - the parent frame

title - the title of the message box

text - the text to display

buttons - the captions of the buttons to display

icon - name/path of icon to display on the left side

MessageBox

public MessageBox(java.lang.String title,
                  java.lang.String text,
                  java.lang.String[] buttons,
                  java.lang.String icon,
                  int width,
                  int height)

displays a dialog with given title, text and buttons

Parameters:

title - the title of the message box

text - the text to display

buttons - the captions of the buttons to display

icon - name/path of icon to display on the left side

MessageBox

public MessageBox(ProperFrame parent,
                  java.lang.String title,
                  java.lang.String text,
                  java.lang.String[] buttons,
                  java.lang.String icon,
                  int width,
                  int height)

displays a dialog with given title, text and buttons

Parameters:

parent - the parent frame

title - the title of the message box

text - the text to display

buttons - the captions of the buttons to display

icon - name/path of icon to display on the left side

Method Detail

getPressedButton

public int getPressedButton()

returns the index of the button that was pressed

Returns:

the index of the button

actionPerformed

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

an action has been invoked

Specified by:

actionPerformed in interface java.awt.event.ActionListener

Overrides:

actionPerformed in class ProperDialog

show

public void show()

displays the dialog

Overrides:

show in class ProperDialog

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

for testing purposes only

Throws:

java.lang.Exception