org.geotools.gui.swing
Class About

Object
  extended by Component
      extended by Container
          extended by JComponent
              extended by JPanel
                  extended by About
All Implemented Interfaces:
ImageObserver, MenuContainer, Serializable, Accessible

public class About
extends JPanel

An "About" dialog box. This dialog box contains the application's title and some system informations (Java and OS version, free memory, image readers and writers, running threads, etc.). The application version can be fetched from a Manifest object, usually build from the META-INF/Manifest.mf file. This manifest should contains entries for Implementation-Title, Implementation-Version and Implementation-Vendor values, as suggested in the Java tutorial. In addition to the above-cited standard entries, the About class understand also an optional Implementation-Date entry. This entry can contains the product date in the "yyyy-MM-dd HH:mm:ss" patter. If presents, this date will be localized according user's locale and appended to the version number.

 

 

Since:
2.0
Author:
Martin Desruisseaux (IRD)
See Also:
Serialized Form
Module:

Nested Class Summary
 
Nested classes/interfaces inherited from class JPanel
JPanel.AccessibleJPanel
 
Nested classes/interfaces inherited from class JComponent
JComponent.AccessibleJComponent
 
Nested classes/interfaces inherited from class Container
Container.AccessibleAWTContainer
 
Nested classes/interfaces inherited from class Component
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
Field Summary
 
Fields inherited from class JComponent
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
 
Fields inherited from class Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
About()
          Construct a new dialog box with the Geotools's logo.
About(Object logo, Attributes attributes, ThreadGroup tasks)
          Constructs a new dialog box from the specified manifest attributes.
About(Object logo, Class application, ThreadGroup tasks)
          Constructs a new dialog box for the specified application class.
 
Method Summary
static void main(String[] args)
          Display the default "About" dialog box.
 void showDialog(Component owner)
          Popups the dialog box and wait for the user.
protected  void start()
          Start a daemon thread updating dialog box information.
protected  void stop()
          Free any resources used by this dialog box.
static void touch(Attributes attributes)
          Convenience method for setting the Implementation-Date attributes to the current date.
 
Methods inherited from class JPanel
getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI
 
Methods inherited from class JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
Methods inherited from class Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
Methods inherited from class Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

About

public About()
Construct a new dialog box with the Geotools's logo.


About

public About(Object logo,
             Class application,
             ThreadGroup tasks)
Constructs a new dialog box for the specified application class. This constructor uses the class loader for loading the manifest file. It also use the class package to find the right entry into the manifest.

Parameters:
logo - The application's logo. It may be a JComponent, an Icon object or an resource path (i.e. a file to be fetch in the classpath) as a String.
application - The application's class. Application name will be fetch from the manifest file (META-INF/Manifest.mf).
tasks - Group of running threads, or null if there is none.

About

public About(Object logo,
             Attributes attributes,
             ThreadGroup tasks)
Constructs a new dialog box from the specified manifest attributes.

Parameters:
logo - The application's logo. It may be a JComponent, an Icon object or an resource path (i.e. a file to be fetch in the classpath) as a String.
attributes - The manifest attributes containing application name and version number.
tasks - Group of running threads, or null if there is none.
Method Detail

showDialog

public void showDialog(Component owner)
Popups the dialog box and wait for the user. This method always invoke start() before showing the dialog, and stop() after disposing it.


start

protected void start()
Start a daemon thread updating dialog box information. Updated information include available memory and the list of running tasks. You must invoke the stop() method after start() (typically in a try..finally construct) in order to free resources. stop() is not automatically invoked by the garbage collector.


stop

protected void stop()
Free any resources used by this dialog box. This method must be invoked after start() in order to free resources. stop() is not automatically invoked by the garbage collector.


touch

public static void touch(Attributes attributes)
Convenience method for setting the Implementation-Date attributes to the current date.

Parameters:
attributes - Attributes in which setting the compilation date.

main

public static void main(String[] args)
Display the default "About" dialog box. This method is usefull for testing the widget appareance and for checking system informations.

Parameters:
args - the command line arguments


Copyright © 1996-2009 Geotools. All Rights Reserved.