uk.ac.starlink.table.gui
Class TableSaveChooser

java.lang.Object
  extended byjava.awt.Component
      extended byjava.awt.Container
          extended byjavax.swing.JComponent
              extended byjavax.swing.JPanel
                  extended byuk.ac.starlink.table.gui.TableSaveChooser
All Implemented Interfaces:
Accessible, ImageObserver, MenuContainer, Serializable

public abstract class TableSaveChooser
extends JPanel

Dialog which permits a user to save a StarTable in a place and format of choice. It should be able to provide suitable dialogs for all the supported table types; in particular it includes a filestore browser and special JDBC connection dialog.

The usual way to use this is to implement getTable() to provide the table which will be saved, and then call showSaveDialog(java.awt.Component).

See Also:
Serialized Form

Nested Class Summary
 
Nested classes inherited from class javax.swing.JPanel
JPanel.AccessibleJPanel
 
Nested classes inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent
 
Nested classes inherited from class java.awt.Container
Container.AccessibleAWTContainer
 
Nested classes inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
Field Summary
 
Fields inherited from class javax.swing.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 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
TableSaveChooser()
          Constructs a saver with a default StarTableOutput.
TableSaveChooser(StarTableOutput sto)
          Constructs a saver with a given StarTableOutput.
 
Method Summary
 void configureFromLoader(TableLoadChooser loader)
          Sets the configuration of this saver up to match that of a loader widget.
 JDialog createDialog(Component parent)
          Creates a dialogue which can be used for user interaction.
 void done()
          Called when the table has been written.
 String getSelectedFormat()
          Returns the currently selected format string.
abstract  StarTable getTable()
          Obtains the table to write.
 StarTableOutput getTableOutput()
          Returns the StarTableOutput object which this saver uses to do the actual writing of the StarTables.
static void main(String[] args)
          Testing purposes only.
 void setEnabled(boolean isEnabled)
           
 void setProgressBar(JProgressBar progBar)
          Sets the progress bar that will be used by this chooser.
 void setSelectedFormat(String format)
          Sets the currently selected format string.
 void setTableOutput(StarTableOutput sto)
          Sets the StarTableOutput object which this saver uses to do the actual writing of the StarTables.
 void showSaveDialog(Component parent)
          Pops up a modal dialogue which interacts with the user to save the table returned by getTable().
 
Methods inherited from class javax.swing.JPanel
getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI
 
Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, 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, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, 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, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, 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 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

TableSaveChooser

public TableSaveChooser()
Constructs a saver with a default StarTableOutput.


TableSaveChooser

public TableSaveChooser(StarTableOutput sto)
Constructs a saver with a given StarTableOutput.

Parameters:
sto - output marshaller
Method Detail

configureFromLoader

public void configureFromLoader(TableLoadChooser loader)
Sets the configuration of this saver up to match that of a loader widget. This will typically involve things like making sure they are viewing the same directory.

Parameters:
loader - loader

setTableOutput

public void setTableOutput(StarTableOutput sto)
Sets the StarTableOutput object which this saver uses to do the actual writing of the StarTables.

Parameters:
sto - the new StarTableOutput to use

getTableOutput

public StarTableOutput getTableOutput()
Returns the StarTableOutput object which this saver uses to do the actual writing of the StarTables.

Returns:
sto the StarTableOutput object

getTable

public abstract StarTable getTable()
Obtains the table to write. This must be implemented by concrete subclasses.

Returns:
table to write

setProgressBar

public void setProgressBar(JProgressBar progBar)
Sets the progress bar that will be used by this chooser. Should be called before the component is displayed to the user.

Parameters:
progBar - progress bar for displaying save progress

done

public void done()
Called when the table has been written.


showSaveDialog

public void showSaveDialog(Component parent)
Pops up a modal dialogue which interacts with the user to save the table returned by getTable().

Parameters:
parent - parent component

setEnabled

public void setEnabled(boolean isEnabled)

getSelectedFormat

public String getSelectedFormat()
Returns the currently selected format string.

Returns:
format label

setSelectedFormat

public void setSelectedFormat(String format)
Sets the currently selected format string.

Parameters:
format - format label

createDialog

public JDialog createDialog(Component parent)
Creates a dialogue which can be used for user interaction.

Parameters:
parent - parent component

main

public static void main(String[] args)
Testing purposes only.


Copyright © 2004 CLRC: Central Laboratory of the Research Councils. All rights reserved.