org.mdiutil.swing

Class JFileSelector

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

org.mdiutil.swing.JFileSelector

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

public class JFileSelector
extends JPanel

File chooser containing a JTextField and a JButton.

• the JTextField allows to write the file path
• the JButton give access to a File Chooser

The two components are connected, so when one of them is modified, the other is modified accordingly.

See Also:

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

Modifier and Type	Field and Description
protected static UnsortableFileChooser	chooser
protected FileSelectorRenderer	fileRenderer The file renderer.
protected String	title The Dialog title.

Fields inherited from class javax.swing.JComponent

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

accessibleContext, 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

Constructors

Constructor and Description
JFileSelector() Create a new FileSelector, without defining a FileChooser name.
JFileSelector(String title) Create a new FileSelector.

Method Summary

Modifier and Type	Method and Description
void	addActionListener(ActionListener listener) Add an ActionListener.
void	addChoosableFileFilter(FileFilter filter) Add a Filefilter to this FileSelector.
void	doLayout()
File	getCurrentDirectory() Return the current Directory of this FileSelector.
String	getDialogTitle() Return the dialog title.
int	getDialogType() Return the type of this dialog.
boolean	getDragEnabled() Return true if drag is enabled.
static JFileChooser	getFileChooser() Return the fileChooser shared by all the instances of the fileSelector.
FileFilter	getFileFilter() Return the currently selected FileFilter.
String	getFileName() Return the associated selected File name.
String	getFilePath() Return the associated selected File path.
int	getFileSelectionMode() Return the associated FileChooser file selection mode.
FileSelectorRenderer	getFileSelectorRenderer() Return the class responsible to render to text associated to the selected files.
String	getName() Return the associated selected File name.
Dimension	getPreferredSize()
File	getSelectedFile() Return the selected File.
File[]	getSelectedFiles() Return the selected files.
FileFilter	getSpecifiedFileFilter() Return the specified FileFilter.
String	getUnselectFileText() Return the text to show on the button for the "Unselect file" option.
boolean	hasOptionalFiles() Return true if the dialog support optional files.
boolean	isDefaultSorted() Return true if the File Chooser use the default sorting of the JDK (alphabetical order).
boolean	isEditable() Return true if the File Selector is editable.
boolean	isEnabled() Return true if the File Selector is enabled.
boolean	isUnselected() Return true for a selection which unselected the file.
static void	main(String[] arg)
void	removeActionListener(ActionListener listener) Removes an ActionListener.
void	removeChoosableFileFilter(FileFilter filter) Remove a Filefilter to this FileSelector.
void	setBackground(Color color) Set the background Color of this FileSelector.
void	setChoosableFileFilters(List<FileFilter> filters) Set the Filefilters for this FileSelector.
void	setChoosableFileFilters(String filters) Set the Filefilters for this FileSelector.
boolean	setCurrentDirectory(File f) Set the current Directory of this FileSelector.
void	setDefaultSorted(boolean isDefaultSorted) Set if the File Chooser use the default sorting of the JDK (alphabetical order), or if the sorting is the order of file selection in the chooser.
void	setDialogTitle(String title) Set the dialog title.
void	setDialogType(int dialogType) Set the type of this dialog.
void	setDragEnabled(boolean b) Set if the drag is enabled.
void	setEditable(boolean b) Set if the component is editable.
void	setEnabled(boolean b) Enables or disables this component, depending on the value of the parameter b.
void	setFileFilter(FileFilter filter) Set the FileFilter to use for the selection.
void	setFileSelectionMode(int mode) Set the associated FileChooser file selection mode.
void	setFileSelectorRenderer(FileSelectorRenderer fileRenderer) Set the class responsible to render to text associated to the selected files.
void	setHasOptionalFiles(boolean hasOptionalFiles) Set if the dialog support optional files.
void	setMultiSelectionEnabled(boolean b) Enable or disable the associated FileChooser multiSelection.
void	setSelectedFile(File f) Set the current selected File of this FileSelector.
void	setSelectedFiles(File[] f) Set the current selected Files of this FileSelector.
protected void	setTextAfterFileSelection(String text) Set the text to show after the files selection.
void	setTransfertHandler(TransferHandler handler) Set the associated TransferHandler.
void	setUnselectFileText(String unselectFileText) Set the text to show on the button for the "Unselect file" option.
String	toString()
void	updateUI()

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI

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, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, 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, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, 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, 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, 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, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, 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, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

chooser

protected static volatile UnsortableFileChooser chooser

title

protected String title

The Dialog title.

fileRenderer

protected FileSelectorRenderer fileRenderer

The file renderer.

Constructor Detail

JFileSelector

public JFileSelector()

Create a new FileSelector, without defining a FileChooser name.

JFileSelector

public JFileSelector(String title)

Create a new FileSelector.

Parameters:

title - the FileChooser title

Method Detail

updateUI

public void updateUI()

Overrides:

updateUI in class JPanel

setHasOptionalFiles

public void setHasOptionalFiles(boolean hasOptionalFiles)

Set if the dialog support optional files. This option will allow to add a button in the UI which specifies the selection is empty.

Parameters:

hasOptionalFiles - true if the dialog support optional files

hasOptionalFiles

public boolean hasOptionalFiles()

Return true if the dialog support optional files. This option will allow to add a button in the UI which specifies the selection is empty.

Returns:

true if the dialog support optional files

setUnselectFileText

public void setUnselectFileText(String unselectFileText)

Set the text to show on the button for the "Unselect file" option.

Parameters:

unselectFileText - the text

getUnselectFileText

public String getUnselectFileText()

Return the text to show on the button for the "Unselect file" option.

Returns:

the text

getFileChooser

public static JFileChooser getFileChooser()

Return the fileChooser shared by all the instances of the fileSelector.

Returns:

the fileChooser shared by all the instances of the fileSelector

setDialogTitle

public void setDialogTitle(String title)

Set the dialog title.

Parameters:

title - the title

getDialogTitle

public String getDialogTitle()

Return the dialog title.

Returns:

the title

setFileSelectorRenderer

public void setFileSelectorRenderer(FileSelectorRenderer fileRenderer)

Set the class responsible to render to text associated to the selected files. Note that is will set the renderer to a DefaultFileSelectorRenderer if the method argument is null.

Parameters:

fileRenderer - the file Renderer

getFileSelectorRenderer

public FileSelectorRenderer getFileSelectorRenderer()

Return the class responsible to render to text associated to the selected files.

Returns:

the file Renderer

setDefaultSorted

public void setDefaultSorted(boolean isDefaultSorted)

Set if the File Chooser use the default sorting of the JDK (alphabetical order), or if the sorting is the order of file selection in the chooser.

Parameters:

isDefaultSorted - true if the File Chooser use the default sorting of the JDK (alphabetical order)

isDefaultSorted

public boolean isDefaultSorted()

Return true if the File Chooser use the default sorting of the JDK (alphabetical order).

Returns:

true if the File Chooser use the default sorting of the JDK (alphabetical order)

getFileSelectionMode

public int getFileSelectionMode()

Return the associated FileChooser file selection mode.

Returns:

the associated FileChooser file selection mode

See Also:

JFileChooser.getFileSelectionMode()

setDragEnabled

public void setDragEnabled(boolean b)

Set if the drag is enabled.

Parameters:

b - true if the drag is enabled

setFileFilter

public void setFileFilter(FileFilter filter)

Set the FileFilter to use for the selection.

Parameters:

filter - the selected FileFilter

getFileFilter

public FileFilter getFileFilter()

Return the currently selected FileFilter.

Returns:

the currently selected FileFilter

getSpecifiedFileFilter

public FileFilter getSpecifiedFileFilter()

Return the specified FileFilter.

Returns:

the specified FileFilter

setTransfertHandler

public void setTransfertHandler(TransferHandler handler)

Set the associated TransferHandler.

Parameters:

handler - the associated TransferHandler

getDragEnabled

public boolean getDragEnabled()

Return true if drag is enabled.

Returns:

true if drag is enabled

setDialogType

public void setDialogType(int dialogType)

Set the type of this dialog. Use OPEN_DIALOG when you want to bring up a file chooser that the user can use to open a file. Use SAVE_DIALOG for letting the user choose a file for saving.

Parameters:

dialogType - the type of this dialog

getDialogType

public int getDialogType()

Return the type of this dialog.

Returns:

the type of this dialog

setFileSelectionMode

public void setFileSelectionMode(int mode)

Set the associated FileChooser file selection mode.

Parameters:

mode - the associated FileChooser file selection mode

See Also:

JFileChooser.setFileSelectionMode(int)

setMultiSelectionEnabled

public void setMultiSelectionEnabled(boolean b)

Enable or disable the associated FileChooser multiSelection.

Parameters:

b - true if the associated FileChooser multiSelection is enabled

See Also:

JFileChooser.setMultiSelectionEnabled(boolean)

getSelectedFile

public File getSelectedFile()

Return the selected File.

Returns:

the selected File

getSelectedFiles

public File[] getSelectedFiles()

Return the selected files.

Returns:

the selected files

setChoosableFileFilters

public void setChoosableFileFilters(String filters)

Set the Filefilters for this FileSelector. This is an alternative for the setChoosableFileFilters(java.util.List) method. The format of the argument is:

 extension1,extension2,...,extension-n;
 

Parameters:

filters - the Filefilters

setChoosableFileFilters

public void setChoosableFileFilters(List<FileFilter> filters)

Set the Filefilters for this FileSelector.

Parameters:

filters - the Filefilters

addChoosableFileFilter

public void addChoosableFileFilter(FileFilter filter)

Add a Filefilter to this FileSelector.

Parameters:

filter - the Filefilter

removeChoosableFileFilter

public void removeChoosableFileFilter(FileFilter filter)

Remove a Filefilter to this FileSelector.

Parameters:

filter - the Filefilter

addActionListener

public void addActionListener(ActionListener listener)

Add an ActionListener.

Parameters:

listener - the ActionListener

removeActionListener

public void removeActionListener(ActionListener listener)

Removes an ActionListener.

Parameters:

listener - the ActionListener

getFileName

public String getFileName()

Return the associated selected File name.

Returns:

the associated selected File name

getFilePath

public String getFilePath()

Return the associated selected File path.

Returns:

the associated selected File path

getName

public String getName()

Return the associated selected File name.

Overrides:

getName in class Component

Returns:

the associated selected File name

toString

public String toString()

Overrides:

toString in class Component

setTextAfterFileSelection

protected final void setTextAfterFileSelection(String text)

Set the text to show after the files selection.

Parameters:

text - the text to show

doLayout

public void doLayout()

Overrides:

doLayout in class Container

getPreferredSize

public Dimension getPreferredSize()

Overrides:

getPreferredSize in class JComponent

setBackground

public void setBackground(Color color)

Set the background Color of this FileSelector.

Overrides:

setBackground in class JComponent

Parameters:

color - the background Color of this FileSelector

setCurrentDirectory

public boolean setCurrentDirectory(File f)

Set the current Directory of this FileSelector.

Parameters:

f - the current Directory to set

Returns:

true if the directory could be set

getCurrentDirectory

public File getCurrentDirectory()

Return the current Directory of this FileSelector.

Returns:

the current Directory of this FileSelector

setSelectedFile

public void setSelectedFile(File f)

Set the current selected File of this FileSelector.

Parameters:

f - the current selected File of this FileSelector

setSelectedFiles

public void setSelectedFiles(File[] f)

Set the current selected Files of this FileSelector.

Parameters:

f - the current selected Files of this FileSelector

setEditable

public void setEditable(boolean b)

Set if the component is editable.

Parameters:

b - true if the component is editable

setEnabled

public void setEnabled(boolean b)

Enables or disables this component, depending on the value of the parameter b.

Overrides:

setEnabled in class JComponent

Parameters:

b - true if the dialog is enabled

isEditable

public boolean isEditable()

Return true if the File Selector is editable.

Returns:

true if the File Selector is enabled

isEnabled

public boolean isEnabled()

Return true if the File Selector is enabled.

Overrides:

isEnabled in class Component

Returns:

true if the File Selector is enabled

isUnselected

public boolean isUnselected()

Return true for a selection which unselected the file.

Returns:

true for a selection which unselected the file

main

public static void main(String[] arg)