schmitzm.swing
Class StatusDialog

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by java.awt.Window
              extended by java.awt.Dialog
                  extended by javax.swing.JDialog
                      extended by schmitzm.swing.StatusDialog
All Implemented Interfaces:
ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants

public class StatusDialog
extends JDialog

Diese Klasse stellt einen modalen Status-Dialog dar. Diese besteht neben einer Meldung aus einem Status-Balken der standardmaessig auf 'indeterminate' eingestellt ist (siehe JProgressBar.setIndeterminate(boolean)). Darueberhinaus kann der Dialog ueber einen Abbrechen-Button beendet werden. Wie auf den Abbruch reagiert wird, ist durch die aufrufende Klasse zu behandeln.

Version:
1.0
Author:
Martin Schmitz (University of Bonn/Germany)
See Also:
Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from class javax.swing.JDialog
JDialog.AccessibleJDialog
 
Nested classes/interfaces inherited from class java.awt.Dialog
Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType
 
Nested classes/interfaces inherited from class java.awt.Window
Window.AccessibleAWTWindow
 
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
 
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
Field Summary
protected  JButton button
          Button um den Dialog zu beenden.
static int CANCEL_OPTION
          Dialog-Option "Abbrechen".
protected  boolean canceled
          Flag signalisiert, ob der Dialog ueber den Button abgebrochen wurde.
protected  int dialogOption
          Typ des Dialogs (Stanard: CANCEL_OPTION).
protected  JLabel messageLabel
          Label in dem die Meldung angezeigt wird.
static int OK_OPTION
          Dialog-Option "Ok".
protected  JProgressBar progressBar
          Status-Balken, der den Fortschritt anzeigt.
 
Fields inherited from class javax.swing.JDialog
accessibleContext, rootPane, rootPaneCheckingEnabled
 
Fields inherited from class java.awt.Dialog
DEFAULT_MODALITY_TYPE
 
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
StatusDialog(Component parent, String title, String message)
          Erzeugt einen neuen Status-Dialog.
StatusDialog(Component parent, String title, String message, double relX, double relY)
          Erzeugt einen neuen Status-Dialog.
StatusDialog(Component parent, String title, String message, Icon icon, double relX, double relY)
          Erzeugt einen neuen Status-Dialog.
 
Method Summary
 JProgressBar getProgressBar()
          Liefert eine Referenz auf den Status-Balken, der im Dialog angezeigt wird.
protected  void insertInformationComponents(Vector<Component> list)
          Fuegt die Informations-Komponenten des Dialogs (Label und Statusbalken) in eine Liste ein.
 boolean isCanceled()
          Prueft, ob das Fenster durch den Button abgebrochen wurde.
 void setDialogOption(int option)
          Setzt die Eigenschaft des Dialog-Buttons.
 void setVisible(boolean visible)
          Zeigt oder verbirgt den Dialog.
 
Methods inherited from class javax.swing.JDialog
addImpl, createRootPane, dialogInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update
 
Methods inherited from class java.awt.Dialog
addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setModalityType, setResizable, setTitle, setUndecorated, show, toBack
 
Methods inherited from class java.awt.Window
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOwnedWindows, getOwner, getOwnerlessWindows, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, 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, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, 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, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, 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, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

CANCEL_OPTION

public static final int CANCEL_OPTION
Dialog-Option "Abbrechen".

See Also:
Constant Field Values

OK_OPTION

public static final int OK_OPTION
Dialog-Option "Ok".

See Also:
Constant Field Values

messageLabel

protected JLabel messageLabel
Label in dem die Meldung angezeigt wird.


progressBar

protected JProgressBar progressBar
Status-Balken, der den Fortschritt anzeigt.


button

protected JButton button
Button um den Dialog zu beenden.


canceled

protected boolean canceled
Flag signalisiert, ob der Dialog ueber den Button abgebrochen wurde.


dialogOption

protected int dialogOption
Typ des Dialogs (Stanard: CANCEL_OPTION).

See Also:
CANCEL_OPTION, OK_OPTION, setDialogOption(int)
Constructor Detail

StatusDialog

public StatusDialog(Component parent,
                    String title,
                    String message)
Erzeugt einen neuen Status-Dialog. Der Dialog wird relativ zum Parent-Fenster zentriert.

Parameters:
parent - uebergeordnetes Fenster (kann null sein!)
title - Titel fuer das Fenster
message - Meldung, die zu dem Status-Balken angezeigt wird

StatusDialog

public StatusDialog(Component parent,
                    String title,
                    String message,
                    double relX,
                    double relY)
Erzeugt einen neuen Status-Dialog.

Parameters:
parent - uebergeordnetes Fenster (kann null sein!)
title - Titel fuer das Fenster
message - Meldung, die zu dem Status-Balken angezeigt wird
relX - relative horizontale Position zum Parent-Fenster
relY - relative vertikale Position zum Parent-Fenster

StatusDialog

public StatusDialog(Component parent,
                    String title,
                    String message,
                    Icon icon,
                    double relX,
                    double relY)
Erzeugt einen neuen Status-Dialog.

Parameters:
parent - uebergeordnetes Fenster (kann null sein!)
title - Titel fuer das Fenster
message - Meldung, die zu dem Status-Balken angezeigt wird
icon - Icon fuer das Status-Fenster
relX - relative horizontale Position zum Parent-Fenster
relY - relative vertikale Position zum Parent-Fenster
Method Detail

insertInformationComponents

protected void insertInformationComponents(Vector<Component> list)
Fuegt die Informations-Komponenten des Dialogs (Label und Statusbalken) in eine Liste ein. Diese werden dann (untereinander) im Dialog angezeigt. Sub-Klassen koennen diese Methode ueberschreiben und weitere Komponenten in die Liste einfuegen.
Bemerke: Der Abbruch-Button ist eine Steuerungskomponente und gehoert nicht zu den Elementen der Liste.

Parameters:
list - Liste von Komponenten, die im Dialog angezeigt werden

getProgressBar

public JProgressBar getProgressBar()
Liefert eine Referenz auf den Status-Balken, der im Dialog angezeigt wird. Hierueber kann dieser formatiert werden.


setDialogOption

public void setDialogOption(int option)
Setzt die Eigenschaft des Dialog-Buttons.

Parameters:
option - CANCEL_OPTION oder OK_OPTION
Throws:
IllegalArgumentException - falls keine der Optionen CANCEL_OPTION oder OK_OPTION angegeben wurde

setVisible

public void setVisible(boolean visible)
Zeigt oder verbirgt den Dialog. Beim Angezeigen wird das canceled-Flag mit false initialisiert.

Overrides:
setVisible in class Dialog

isCanceled

public boolean isCanceled()
Prueft, ob das Fenster durch den Button abgebrochen wurde.