Package nz.ac.waikato.cms.gui.core
Class FileChooserPanel
java.lang.Object
- All Implemented Interfaces:
ImageObserver,MenuContainer,Serializable,Accessible
A panel that contains a text field with the current file/directory and a
button for bringing up a BaseFileChooser.
- Author:
- fracpete (fracpete at waikato dot ac dot nz)
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from class nz.ac.waikato.cms.gui.core.AbstractChooserPanel
AbstractChooserPanel.PopupMenuCustomizerNested classes/interfaces inherited from class javax.swing.JPanel
JPanel.AccessibleJPanelNested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponentNested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainerNested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy -
Field Summary
FieldsModifier and TypeFieldDescriptionprotected BaseFileChooserthe JFileChooser for selecting a file.protected booleanwhether to use the open or save dialog.Fields inherited from class nz.ac.waikato.cms.gui.core.AbstractChooserPanel
m_ButtonSelection, m_ChangeListeners, m_Editable, m_InlineEditingEnabled, m_LabelPrefix, m_LabelPrefixSpacer, m_PanelButtons, m_PanelPrefix, m_PopupMenuCustomizer, m_Self, m_TextSelectionFields inherited from class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOWFields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTFields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH -
Constructor Summary
ConstructorsConstructorDescriptionInitializes the panel with no file.FileChooserPanel(File path) Initializes the panel with the given filename/directory.FileChooserPanel(String path) Initializes the panel with the given filename/directory. -
Method Summary
Modifier and TypeMethodDescriptionvoidaddChoosableFileFilter(FileFilter value) Adds the given file filter to the filechooser.protected FiledoChoose()Performs the actual choosing of an object.protected FilefromString(String value) Converts the string representation into its object representation.Returns all choosable file filters.Returns the current directory in use by the file chooser.Returns the active file filter.intReturns the selection mode, whether only files or directories, or both can be selected.booleanReturns whether the save or open dialog is used.protected voidInitializes the members.booleanReturns whether the "accept all files" filter is used.voidRemoves the specified file filter from the filechooser.voidRemoves all file filters from the filechooser.voidsetAcceptAllFileFilterUsed(boolean value) Sets whether the "accept all files" filter is used.booleansetCurrent(File value) Sets the current value.voidsetCurrentDirectory(File value) Sets the current directory to use for the file chooser.voidsetFileFilter(FileFilter value) Sets the active file filter.voidsetFileSelectionMode(int value) Sets the selection mode, whether only files or directories, or both can be selected.voidsetUseSaveDialog(boolean value) Sets whether to use the save or open dialog.protected StringConverts the value into its string representation.Methods inherited from class nz.ac.waikato.cms.gui.core.AbstractChooserPanel
addChangeListener, choose, cleanUp, copyToClipboard, fireCurrentValueChanged, getCurrent, getDefaultString, getPopupMenu, getPopupMenuCustomizer, getPrefix, getPrefixLabel, getSelectionColumns, getStringFromClipboard, getTextColumns, grabFocus, hasValue, initGUI, isEditable, isInlineEditingEnabled, moveChooseButton, notifyChangeListeners, pasteFromClipboard, removeChangeListener, setDefault, setEditable, setEnabled, setInlineEditingEnabled, setPopupMenuCustomizer, setPrefix, setTextColumns, setToolTipText, updatePreferredSizeMethods inherited from class nz.ac.waikato.cms.gui.core.BasePanel
finishInitMethods inherited from class javax.swing.JPanel
getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUIMethods 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, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, 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, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, updateMethods 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, transferFocusDownCycle, validate, validateTreeMethods 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, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
Field Details
-
m_FileChooser
the JFileChooser for selecting a file. -
m_UseSaveDialog
protected boolean m_UseSaveDialogwhether to use the open or save dialog.
-
-
Constructor Details
-
FileChooserPanel
public FileChooserPanel()Initializes the panel with no file. -
FileChooserPanel
Initializes the panel with the given filename/directory.- Parameters:
path- the filename/directory to use
-
FileChooserPanel
Initializes the panel with the given filename/directory.- Parameters:
path- the filename/directory to use
-
-
Method Details
-
initialize
protected void initialize()Initializes the members.- Overrides:
initializein classAbstractChooserPanel<File>
-
doChoose
Performs the actual choosing of an object.- Specified by:
doChoosein classAbstractChooserPanel<File>- Returns:
- the chosen object or null if none chosen
-
toString
Converts the value into its string representation.- Specified by:
toStringin classAbstractChooserPanel<File>- Parameters:
value- the value to convert- Returns:
- the generated string
-
fromString
Converts the string representation into its object representation.- Specified by:
fromStringin classAbstractChooserPanel<File>- Parameters:
value- the string value to convert- Returns:
- the generated object
-
setFileSelectionMode
public void setFileSelectionMode(int value) Sets the selection mode, whether only files or directories, or both can be selected. FILES_ONLY is the default.- Parameters:
value- the mode
-
getFileSelectionMode
public int getFileSelectionMode()Returns the selection mode, whether only files or directories, or both can be selected. FILES_ONLY is the default.- Returns:
- the mode
- See Also:
-
addChoosableFileFilter
Adds the given file filter to the filechooser.- Parameters:
value- the file filter to add
-
removeChoosableFileFilter
Removes the specified file filter from the filechooser.- Parameters:
value- the file filter to remove
-
removeChoosableFileFilters
public void removeChoosableFileFilters()Removes all file filters from the filechooser. -
getChoosableFileFilters
Returns all choosable file filters.- Returns:
- the current file filters
-
setAcceptAllFileFilterUsed
public void setAcceptAllFileFilterUsed(boolean value) Sets whether the "accept all files" filter is used.- Parameters:
value- if true then the filter will be used
-
isAcceptAllFileFilterUsed
public boolean isAcceptAllFileFilterUsed()Returns whether the "accept all files" filter is used.- Returns:
- true if the filter is used
-
setFileFilter
Sets the active file filter.- Parameters:
value- the file filter to select
-
getFileFilter
Returns the active file filter.- Returns:
- the current file filter
-
setCurrentDirectory
Sets the current directory to use for the file chooser.- Parameters:
value- the current directory
-
getCurrentDirectory
Returns the current directory in use by the file chooser.- Returns:
- the current directory
-
setCurrent
Sets the current value.- Overrides:
setCurrentin classAbstractChooserPanel<File>- Parameters:
value- the value to use, can be null- Returns:
- true if successfully set
-
setUseSaveDialog
public void setUseSaveDialog(boolean value) Sets whether to use the save or open dialog.- Parameters:
value- if true the save dialog is used
-
getUseSaveDialog
public boolean getUseSaveDialog()Returns whether the save or open dialog is used.- Returns:
- true if the save dialog is used
-