jas.util
Class OpenLocalFilePanel

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  jas.util.OpenLocalFilePanel

All Implemented Interfaces:

ActionListener, ImageObserver, MenuContainer, Serializable, EventListener, Accessible, ChangeListener

public class OpenLocalFilePanel
extends JPanel
implements ActionListener, ChangeListener

This class provides a convenient way to get a file name from the user. It is merely a panel with a text field for the file name with some built in convenience items. This panel does not actually open a file for you; it simply provides an easy way to get a file name from the user. Use getText() to get the file name selected.

• The text field is in fact a JASEditableComboBox, so recently selected files are available on a drop-down list. The drop-down list is stored in the Application's UserProperties object according to a key that you specify for the constructor.
• A "Browse..." button opens a file dialog so that the user can select a file. The object will remember the last directory used according to the given key and open the dialog to that directory the next time it is opened.
• Optionally, you can have a "Preview..." button that opens a dialog showing the beginning of the file.
• Optionally, you can have GZip option, where the user can select whether the file in in GZip format.
• If you add an ActionListener to this class, you will receive ActionEvents from the JASEditableComboBox. An ActionEvent will be sent only when the 'Enter' button is clicked in the text field. Similarly, if you add a ChangeListener to this class, you will receive ChangeEvents from the JASEditableComboBox. A ChangeEvent will be sent every time the visible text changes.

Be sure to invoke the saveState() method when you are done. This will set include the selected file in the drop-down list for the next time the panel is used.

Author:

Jonas Gifford, Tony Johnson

See Also:

JASEditableComboBox, UserProperties, getText(), saveState(), Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

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

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

OpenLocalFilePanel(boolean includePreviewButton, boolean includeGZIP, String key)
Creates an OpenLocalFilePanel component that you can add to a container.

OpenLocalFilePanel(boolean includePreviewButton, boolean includeGZIP, String key, FileFilter filter)
Creates an OpenLocalFilePanel component that you can add to a container.

Method Summary

void	actionPerformed(ActionEvent e) This method is public as an implelentation side effect; do not call.
void	addActionListener(ActionListener al) The given ActionListener will be notified when the "Enter" button is clicked in the file name text field.
void	addChangeListener(ChangeListener cl) The given ChangeListener will be notified when the visible text changes in the file name field.
boolean	getGZIPed() Returns whether the user has selected the GZip option.
String	getText() Returns the file name showing in the text field.
void	saveState() Includes the currently selected file name in the drop-down list for the next time this class is instantiated.
void	stateChanged(ChangeEvent e) This method is public as an implelentation side effect; do not call.

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, 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, isPaintingForPrint, 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 java.awt.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 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, 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 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

OpenLocalFilePanel

public OpenLocalFilePanel(boolean includePreviewButton,
                          boolean includeGZIP,
                          String key,
                          FileFilter filter)

Creates an OpenLocalFilePanel component that you can add to a container.

Parameters:

includePreviewButton - whether a "Preview" button should be shown

includeGZIP - whether the GZip option should be shown

key - the key used to store the drop-down items and the last directory for the browse dialog

filter - sets a FileFilter for the browse dialog

OpenLocalFilePanel

public OpenLocalFilePanel(boolean includePreviewButton,
                          boolean includeGZIP,
                          String key)

Creates an OpenLocalFilePanel component that you can add to a container.

Parameters:

includePreviewButton - whether a "Preview" button should be shown

includeGZIP - whether the GZip option should be shown

key - the key used to store the drop-down items and the last directory for the browse dialog

Method Detail

addChangeListener

public void addChangeListener(ChangeListener cl)

The given ChangeListener will be notified when the visible text changes in the file name field.

addActionListener

public void addActionListener(ActionListener al)

The given ActionListener will be notified when the "Enter" button is clicked in the file name text field.

stateChanged

public final void stateChanged(ChangeEvent e)

This method is public as an implelentation side effect; do not call.

Specified by:

stateChanged in interface ChangeListener

actionPerformed

public final void actionPerformed(ActionEvent e)

This method is public as an implelentation side effect; do not call.

Specified by:

actionPerformed in interface ActionListener

getText

public String getText()

Returns the file name showing in the text field.

Returns:

the selected file name

saveState

public void saveState()

Includes the currently selected file name in the drop-down list for the next time this class is instantiated. It merely invokes the saveState() method in the JASEditableComboBox that is shown on the panel.

See Also:

JASEditableComboBox, JASEditableComboBox.saveState()

getGZIPed

public boolean getGZIPed()

Returns whether the user has selected the GZip option. If the GZip option was not available (i.e., in the constructor the parameter includeGZIP was false) then it will return false.

Returns:

whether the GZip option was selected