javax.swing
public class JFileChooser extends JComponent implements Accessible
FileFilter
instance using
addChoosableFileFilter(FileFilter)
. Additional components can
be embedded in the file chooser using setAccessory(JComponent)
.
The JFileChooser properties also provide mechanisms to customize the
behaviour of the file chooser.Modifier and Type | Class and Description |
---|---|
protected class |
JFileChooser.AccessibleJFileChooser
Provides the accessibility features for the
JFileChooser
component. |
JComponent.AccessibleJComponent
Container.AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
Modifier and Type | Field and Description |
---|---|
static String |
ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY
The name of the 'accept all file filter used' property.
|
protected AccessibleContext |
accessibleContext
The accessible context.
|
static String |
ACCESSORY_CHANGED_PROPERTY
The name of the 'accessory' property.
|
static String |
APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY
The name of the property for the approve button mnemonic.
|
static String |
APPROVE_BUTTON_TEXT_CHANGED_PROPERTY
The name of the property for the approve button text.
|
static String |
APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY
The name of the property for the approve button tool tip text.
|
static int |
APPROVE_OPTION
A return value indicating the file chooser has been closed by approving
the selection.
|
static String |
APPROVE_SELECTION
Action command string for approving the current selection.
|
static int |
CANCEL_OPTION
A return value indicating the file chooser has been closed by cancelling.
|
static String |
CANCEL_SELECTION
Action command string for cancelling the current selection.
|
static String |
CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY
The name of the 'choosable file filters' property.
|
static String |
CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
The name of the property for control button visibility.
|
static int |
CUSTOM_DIALOG
A dialog type for some custom purpose.
|
static String |
DIALOG_TITLE_CHANGED_PROPERTY
The name of the 'dialog title' property.
|
static String |
DIALOG_TYPE_CHANGED_PROPERTY
The name of the 'dialog type' property.
|
static int |
DIRECTORIES_ONLY
A selection mode constant indicating acceptance of directories only.
|
static String |
DIRECTORY_CHANGED_PROPERTY
The name of the property for the current directory.
|
static int |
ERROR_OPTION
A return value indicating the file chooser has been closed by some error.
|
static String |
FILE_FILTER_CHANGED_PROPERTY
The name of the 'file filter' property.
|
static String |
FILE_HIDING_CHANGED_PROPERTY
The name of the 'file hiding enabled' property.
|
static String |
FILE_SELECTION_MODE_CHANGED_PROPERTY
The name of the 'file selection mode' property.
|
static String |
FILE_SYSTEM_VIEW_CHANGED_PROPERTY
The name of the 'file system view' property.
|
static String |
FILE_VIEW_CHANGED_PROPERTY
The name of the 'file view' property.
|
static int |
FILES_AND_DIRECTORIES
A selection mode constant indicating acceptance of files and directories.
|
static int |
FILES_ONLY
A selection mode constant indicating acceptance of files only.
|
static String |
MULTI_SELECTION_ENABLED_CHANGED_PROPERTY
The name of the property for multi-selection.
|
static int |
OPEN_DIALOG
A dialog type for selecting a file to open.
|
static int |
SAVE_DIALOG
A dialog type for selecting a file to save.
|
static String |
SELECTED_FILE_CHANGED_PROPERTY
The name of the property for the selected file.
|
static String |
SELECTED_FILES_CHANGED_PROPERTY
The name of the property for the selected files.
|
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Constructor and Description |
---|
JFileChooser()
Creates a new
JFileChooser object. |
JFileChooser(File currentDirectory)
Creates a new
JFileChooser object. |
JFileChooser(File currentDirectory,
FileSystemView fsv)
Creates a new
JFileChooser object. |
JFileChooser(FileSystemView fsv)
Creates a new
JFileChooser object. |
JFileChooser(String currentDirectoryPath)
Creates a new
JFileChooser object. |
JFileChooser(String currentDirectoryPath,
FileSystemView fsv)
Creates a new
JFileChooser object with the specified
directory and FileSystemView . |
Modifier and Type | Method and Description |
---|---|
boolean |
accept(File f)
Returns
true if the file is accepted by the current
file filter. |
void |
addActionListener(ActionListener l)
Adds an
ActionListener to the file chooser. |
void |
addChoosableFileFilter(FileFilter filter)
Adds a file filter to the list of available filters and sends a
PropertyChangeEvent (with the property name
CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY ) to all registered
listeners. |
void |
approveSelection()
Approves the selection.
|
void |
cancelSelection()
Cancels the selection.
|
void |
changeToParentDirectory()
Called by the UI delegate when the parent directory is changed.
|
protected JDialog |
createDialog(Component parent)
Creates a modal dialog in which to display the file chooser.
|
void |
ensureFileIsVisible(File f)
Ensures the the specified file is visible (this is handled by the
UI delegate).
|
protected void |
fireActionPerformed(String command)
Sends an @link {ActionEvent} to all registered listeners.
|
FileFilter |
getAcceptAllFileFilter()
Returns the 'accept all' file filter from the UI delegate.
|
AccessibleContext |
getAccessibleContext()
Returns the object that provides accessibility features for this
JFileChooser component. |
JComponent |
getAccessory()
Returns the accessory component for the file chooser.
|
ActionListener[] |
getActionListeners()
Returns the action listeners registered with this file chooser.
|
int |
getApproveButtonMnemonic()
Returns the approve button mnemonic, or zero if no mnemonic has been set.
|
String |
getApproveButtonText()
Returns the approve button text.
|
String |
getApproveButtonToolTipText()
Returns the tool tip text for the approve button.
|
FileFilter[] |
getChoosableFileFilters()
Returns the available file filters for this file chooser.
|
boolean |
getControlButtonsAreShown()
Returns the flag that controls whether or not the control buttons are
shown on the file chooser.
|
File |
getCurrentDirectory()
Returns the current directory.
|
String |
getDescription(File f)
Returns the description of the file, generated by the current (or default)
FileView . |
String |
getDialogTitle()
Returns the dialog title.
|
int |
getDialogType()
Returns the type of file chooser.
|
boolean |
getDragEnabled()
Returns true if dragging is enabled.
|
FileFilter |
getFileFilter()
Returns the file filter.
|
int |
getFileSelectionMode()
|
FileSystemView |
getFileSystemView()
Returns the file system view being used by this file chooser.
|
FileView |
getFileView()
Returns the custom
FileView for the file chooser. |
Icon |
getIcon(File f)
Returns the icon provided by the current (or default)
FileView . |
String |
getName(File f)
Returns the name of the file, generated by the current (or default)
FileView . |
File |
getSelectedFile()
Returns the selected file, if there is one.
|
File[] |
getSelectedFiles()
Returns the selected file or files in an array.
|
String |
getTypeDescription(File f)
Returns the type description for the file, generated by the current (or
default)
FileView . |
FileChooserUI |
getUI()
Returns the UI delegate for the component.
|
String |
getUIClassID()
Returns the UI delegate class identifier.
|
boolean |
isAcceptAllFileFilterUsed()
Returns the flag that controls whether or not the 'accept all' file
filter is included in the list of filters.
|
boolean |
isDirectorySelectionEnabled()
Returns
true if directory selection is enabled, and
false otherwise. |
boolean |
isFileHidingEnabled()
Returns
true if hidden files are to be hidden, and
false otherwise. |
boolean |
isFileSelectionEnabled()
Returns
true if file selection is enabled, and
false otherwise. |
boolean |
isMultiSelectionEnabled()
Returns
true if multiple selections are allowed within this
file chooser, and false otherwise. |
boolean |
isTraversable(File f)
Returns
true if the file is traversable, and
false otherwise. |
protected String |
paramString()
Returns a string describing the attributes for the
JFileChooser component, for use in debugging. |
void |
removeActionListener(ActionListener l)
Removes an
ActionListener from this file chooser. |
boolean |
removeChoosableFileFilter(FileFilter f)
Removes a file filter from the list of available filters and sends a
PropertyChangeEvent (with the property name
CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY ) to all registered
listeners. |
void |
rescanCurrentDirectory()
Rescans the current directory (this is handled by the UI delegate).
|
void |
resetChoosableFileFilters()
Clears the list of choosable file filters and installs the 'accept all'
filter from the UI delegate.
|
void |
setAcceptAllFileFilterUsed(boolean b)
Sets the flag that controls whether or not the 'accept all' file filter
is included in the list of filters, and sends a
PropertyChangeEvent (with the property name
ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY ) to all registered
listeners. |
void |
setAccessory(JComponent newAccessory)
Sets the accessory component for the file chooser and sends a
PropertyChangeEvent to all registered listeners. |
void |
setApproveButtonMnemonic(char mnemonic)
Sets the mnemonic for the approve button and sends a
PropertyChangeEvent (with the property name
APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY ) to all registered
listeners. |
void |
setApproveButtonMnemonic(int mnemonic)
Sets the mnemonic for the approve button and sends a
PropertyChangeEvent (with the property name
APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY ) to all registered
listeners. |
void |
setApproveButtonText(String approveButtonText)
Sets the approve button text and fires a
PropertyChangeEvent
(with the property name APPROVE_BUTTON_TEXT_CHANGED_PROPERTY ) to
all registered listeners. |
void |
setApproveButtonToolTipText(String toolTipText)
Sets the tool tip text for the approve button and sends a
PropertyChangeEvent (with the property name
APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY ) to all
registered listeners. |
void |
setControlButtonsAreShown(boolean b)
Sets the flag that controls whether or not the control buttons are
shown and, if it changes, sends a
PropertyChangeEvent (with the
property name CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY ) to
all registered listeners. |
void |
setCurrentDirectory(File dir)
Sets the current directory and fires a
PropertyChangeEvent (with
the property name DIRECTORY_CHANGED_PROPERTY ) to all registered
listeners. |
void |
setDialogTitle(String dialogTitle)
Sets the dialog title and sends a
PropertyChangeEvent (with the
property name DIALOG_TITLE_CHANGED_PROPERTY ) to all
registered listeners. |
void |
setDialogType(int dialogType)
Sets the dialog type and fires a
PropertyChangeEvent (with the
property name DIALOG_TYPE_CHANGED_PROPERTY ) to all
registered listeners. |
void |
setDragEnabled(boolean b)
Sets the dragEnabled property, this disables/enables automatic drag
handling (drag and drop) on this component.
|
void |
setFileFilter(FileFilter filter)
Sets the file filter and sends a
PropertyChangeEvent (with the
property name FILE_FILTER_CHANGED_PROPERTY ) to all registered
listeners. |
void |
setFileHidingEnabled(boolean b)
Sets the flag that controls whether or not hidden files are displayed,
and sends a
PropertyChangeEvent (with the property name
FILE_HIDING_CHANGED_PROPERTY ) to all registered listeners. |
void |
setFileSelectionMode(int mode)
Sets the file selection mode and sends a
PropertyChangeEvent
to all registered listeners. |
void |
setFileSystemView(FileSystemView fsv)
Sets the file system view for the file chooser and sends a
PropertyChangeEvent to all registered listeners. |
void |
setFileView(FileView fileView)
Sets a custom
FileView for the file chooser and sends a
PropertyChangeEvent to all registered listeners. |
void |
setMultiSelectionEnabled(boolean b)
Sets the flag that controls whether multiple selections are allowed in
this filechooser and sends a
PropertyChangeEvent (with the
property name MULTI_SELECTION_ENABLED_CHANGED_PROPERTY ) to all
registered listeners. |
void |
setSelectedFile(File file)
Sets the selected file and sends a
PropertyChangeEvent to all
registered listeners. |
void |
setSelectedFiles(File[] selectedFiles)
Sets the selected files and sends a
PropertyChangeEvent (with the
name SELECTED_FILES_CHANGED_PROPERTY ) to all registered
listeners. |
protected void |
setup(FileSystemView view)
Sets up the file chooser.
|
int |
showDialog(Component parent,
String approveButtonText)
Displays the file chooser in a modal dialog using the
CUSTOM_DIALOG type. |
int |
showOpenDialog(Component parent)
Displays the file chooser in a modal dialog using the
OPEN_DIALOG type. |
int |
showSaveDialog(Component parent)
Displays the file chooser in a modal dialog using the
SAVE_DIALOG type. |
void |
updateUI()
Installs the UI delegate for the current look and feel.
|
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, 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, 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, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setNextFocusableComponent, setOpaque, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
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, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
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, firePropertyChange, 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, 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, processMouseEvent, 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, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
public static final int OPEN_DIALOG
setDialogType(int)
,
Constant Field Valuespublic static final int SAVE_DIALOG
setDialogType(int)
,
Constant Field Valuespublic static final int CUSTOM_DIALOG
setDialogType(int)
,
Constant Field Valuespublic static final int CANCEL_OPTION
public static final int APPROVE_OPTION
public static final int ERROR_OPTION
public static final int FILES_ONLY
public static final int DIRECTORIES_ONLY
public static final int FILES_AND_DIRECTORIES
public static final String CANCEL_SELECTION
cancelSelection()
,
Constant Field Valuespublic static final String APPROVE_SELECTION
cancelSelection()
,
Constant Field Valuespublic static final String APPROVE_BUTTON_TEXT_CHANGED_PROPERTY
public static final String APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY
public static final String APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY
public static final String CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
public static final String DIRECTORY_CHANGED_PROPERTY
public static final String SELECTED_FILE_CHANGED_PROPERTY
setSelectedFile(File)
,
Constant Field Valuespublic static final String SELECTED_FILES_CHANGED_PROPERTY
public static final String MULTI_SELECTION_ENABLED_CHANGED_PROPERTY
public static final String FILE_SYSTEM_VIEW_CHANGED_PROPERTY
public static final String FILE_VIEW_CHANGED_PROPERTY
setFileView(FileView)
,
Constant Field Valuespublic static final String FILE_HIDING_CHANGED_PROPERTY
public static final String FILE_FILTER_CHANGED_PROPERTY
public static final String FILE_SELECTION_MODE_CHANGED_PROPERTY
public static final String ACCESSORY_CHANGED_PROPERTY
public static final String ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY
public static final String DIALOG_TITLE_CHANGED_PROPERTY
setDialogTitle(String)
,
Constant Field Valuespublic static final String DIALOG_TYPE_CHANGED_PROPERTY
setDialogType(int)
,
Constant Field Valuespublic static final String CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY
protected AccessibleContext accessibleContext
getAccessibleContext()
public JFileChooser()
JFileChooser
object.public JFileChooser(String currentDirectoryPath)
JFileChooser
object.currentDirectoryPath
- the directory that should initially be
shown in the filechooser (if null
, the user's home
directory is used).public JFileChooser(String currentDirectoryPath, FileSystemView fsv)
JFileChooser
object with the specified
directory and FileSystemView
.currentDirectoryPath
- the directory that should initially be
shown in the filechooser (if null
, the user's home
directory is used).fsv
- the file system view (if null
, the default file
system view is used).public JFileChooser(File currentDirectory)
JFileChooser
object.currentDirectory
- the directory that should initially be
shown in the filechooser (if null
, the user's home
directory is used).public JFileChooser(FileSystemView fsv)
JFileChooser
object.fsv
- the file system view (if null
, the default file
system view is used).public JFileChooser(File currentDirectory, FileSystemView fsv)
JFileChooser
object.currentDirectory
- the directory that should initially be
shown in the filechooser (if null
, the user's home
directory is used).fsv
- the file system view (if null
, the default file
system view is used).protected void setup(FileSystemView view)
view
- the file system view (if null
, the default file
system view is used).FileSystemView.getFileSystemView()
public void setDragEnabled(boolean b)
b
- - the new dragEnabled valuepublic boolean getDragEnabled()
public File getSelectedFile()
null
).setSelectedFile(File)
public void setSelectedFile(File file)
PropertyChangeEvent
to all
registered listeners. The property name is
SELECTED_FILE_CHANGED_PROPERTY
.file
- the file (null
permitted).public File[] getSelectedFiles()
public void setSelectedFiles(File[] selectedFiles)
PropertyChangeEvent
(with the
name SELECTED_FILES_CHANGED_PROPERTY
) to all registered
listeners.selectedFiles
- the selected files (null
permitted).public File getCurrentDirectory()
public void setCurrentDirectory(File dir)
PropertyChangeEvent
(with
the property name DIRECTORY_CHANGED_PROPERTY
) to all registered
listeners. If dir
is null
, the current
directory is set to the default directory returned by the file system
view.dir
- the new directory (null
permitted).FileSystemView.getDefaultDirectory()
public void changeToParentDirectory()
public void rescanCurrentDirectory()
public void ensureFileIsVisible(File f)
f
- the file.public int showOpenDialog(Component parent) throws HeadlessException
OPEN_DIALOG
type.parent
- the parent component.APPROVE_OPTION
, CANCEL_OPTION
and
ERROR_OPTION
).HeadlessException
- DOCUMENT ME!public int showSaveDialog(Component parent) throws HeadlessException
SAVE_DIALOG
type.parent
- the parent component.APPROVE_OPTION
, CANCEL_OPTION
and
ERROR_OPTION
).HeadlessException
- DOCUMENT ME!public int showDialog(Component parent, String approveButtonText) throws HeadlessException
CUSTOM_DIALOG
type.parent
- the parent component.APPROVE_OPTION
, CANCEL_OPTION
and
ERROR_OPTION
).HeadlessException
- DOCUMENT ME!protected JDialog createDialog(Component parent) throws HeadlessException
parent
- the parent component.HeadlessException
- DOCUMENT ME!public boolean getControlButtonsAreShown()
setControlButtonsAreShown(boolean)
public void setControlButtonsAreShown(boolean b)
PropertyChangeEvent
(with the
property name CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
) to
all registered listeners.b
- the new value for the flag.public int getDialogType()
OPEN_DIALOG
, SAVE_DIALOG
or
CUSTOM_DIALOG
.setDialogType(int)
public void setDialogType(int dialogType)
PropertyChangeEvent
(with the
property name DIALOG_TYPE_CHANGED_PROPERTY
) to all
registered listeners.dialogType
- the dialog type (one of: OPEN_DIALOG
,
SAVE_DIALOG
, CUSTOM_DIALOG
).IllegalArgumentException
- if dialogType
is not valid.public void setDialogTitle(String dialogTitle)
PropertyChangeEvent
(with the
property name DIALOG_TITLE_CHANGED_PROPERTY
) to all
registered listeners.dialogTitle
- the dialog title (null
permitted).getDialogTitle()
public String getDialogTitle()
null
).setDialogTitle(String)
public void setApproveButtonToolTipText(String toolTipText)
PropertyChangeEvent
(with the property name
APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY
) to all
registered listeners.toolTipText
- the text.public String getApproveButtonToolTipText()
setApproveButtonToolTipText(String)
public int getApproveButtonMnemonic()
setApproveButtonMnemonic(int)
public void setApproveButtonMnemonic(int mnemonic)
PropertyChangeEvent
(with the property name
APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY
) to all registered
listeners.mnemonic
- the mnemonic.setApproveButtonMnemonic(char)
public void setApproveButtonMnemonic(char mnemonic)
PropertyChangeEvent
(with the property name
APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY
) to all registered
listeners.mnemonic
- the mnemonic.setApproveButtonMnemonic(int)
public void setApproveButtonText(String approveButtonText)
PropertyChangeEvent
(with the property name APPROVE_BUTTON_TEXT_CHANGED_PROPERTY
) to
all registered listeners.approveButtonText
- the text (null
permitted).getApproveButtonText()
public String getApproveButtonText()
null
).setApproveButtonText(String)
public FileFilter[] getChoosableFileFilters()
public void addChoosableFileFilter(FileFilter filter)
PropertyChangeEvent
(with the property name
CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY
) to all registered
listeners.filter
- the filter (null
permitted).public boolean removeChoosableFileFilter(FileFilter f)
PropertyChangeEvent
(with the property name
CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY
) to all registered
listeners.f
- the file filter.true
if the filter was removed and
false
otherwise.public void resetChoosableFileFilters()
public FileFilter getAcceptAllFileFilter()
public boolean isAcceptAllFileFilterUsed()
setAcceptAllFileFilterUsed(boolean)
public void setAcceptAllFileFilterUsed(boolean b)
PropertyChangeEvent
(with the property name
ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY
) to all registered
listeners.b
- the new value of the flag.public JComponent getAccessory()
null
.null
).setAccessory(JComponent)
public void setAccessory(JComponent newAccessory)
PropertyChangeEvent
to all registered listeners. The property
name is ACCESSORY_CHANGED_PROPERTY
.newAccessory
- the accessory component.public void setFileSelectionMode(int mode)
PropertyChangeEvent
to all registered listeners. The property name is
FILE_SELECTION_MODE_CHANGED_PROPERTY
.mode
- the mode (FILES_ONLY
, DIRECTORIES_ONLY
or
FILES_AND_DIRECTORIES
).IllegalArgumentException
- if the mode is invalid.public int getFileSelectionMode()
FILES_ONLY
,
DIRECTORIES_ONLY
or FILES_AND_DIRECTORIES
. The
default is FILES_ONLY
.setFileSelectionMode(int)
public boolean isFileSelectionEnabled()
true
if file selection is enabled, and
false
otherwise. File selection is enabled when the
file selection mode is FILES_ONLY
or
FILES_AND_DIRECTORIES
.true
if file selection is enabled.getFileSelectionMode()
public boolean isDirectorySelectionEnabled()
true
if directory selection is enabled, and
false
otherwise. Directory selection is enabled when the
file selection mode is DIRECTORIES_ONLY
or
FILES_AND_DIRECTORIES
.true
if file selection is enabled.getFileSelectionMode()
public void setMultiSelectionEnabled(boolean b)
PropertyChangeEvent
(with the
property name MULTI_SELECTION_ENABLED_CHANGED_PROPERTY
) to all
registered listeners.b
- the new value of the flag.public boolean isMultiSelectionEnabled()
true
if multiple selections are allowed within this
file chooser, and false
otherwise.setMultiSelectionEnabled(boolean)
public boolean isFileHidingEnabled()
true
if hidden files are to be hidden, and
false
otherwise.setFileHidingEnabled(boolean)
public void setFileHidingEnabled(boolean b)
PropertyChangeEvent
(with the property name
FILE_HIDING_CHANGED_PROPERTY
) to all registered listeners.b
- the new value of the flag.public void setFileFilter(FileFilter filter)
PropertyChangeEvent
(with the
property name FILE_FILTER_CHANGED_PROPERTY
) to all registered
listeners.filter
- the filter (null
permitted).public FileFilter getFileFilter()
setFileFilter(FileFilter)
public void setFileView(FileView fileView)
FileView
for the file chooser and sends a
PropertyChangeEvent
to all registered listeners. The property
name is FILE_VIEW_CHANGED_PROPERTY
.fileView
- the file view (null
permitted).getFileView()
public FileView getFileView()
FileView
for the file chooser.null
).public String getName(File f)
FileView
.f
- the file.public String getDescription(File f)
FileView
.f
- the file.public String getTypeDescription(File f)
FileView
.f
- the file.public Icon getIcon(File f)
FileView
.f
- the file.public boolean isTraversable(File f)
true
if the file is traversable, and
false
otherwise.f
- the file or directory.public boolean accept(File f)
true
if the file is accepted by the current
file filter.f
- the file.public void setFileSystemView(FileSystemView fsv)
PropertyChangeEvent
to all registered listeners.fsv
- the file system view.public FileSystemView getFileSystemView()
setFileSystemView(FileSystemView)
public void approveSelection()
ActionEvent
is sent to all registered
listeners.public void cancelSelection()
ActionEvent
is sent to all registered
listeners.public void addActionListener(ActionListener l)
ActionListener
to the file chooser.l
- the listener.public void removeActionListener(ActionListener l)
ActionListener
from this file chooser.l
- the listener.public ActionListener[] getActionListeners()
protected void fireActionPerformed(String command)
command
- the action command.public void updateUI()
updateUI
in class JComponent
public String getUIClassID()
getUIClassID
in class JComponent
FileChooserUI
.JComponent.setUI(javax.swing.plaf.ComponentUI)
,
JComponent.updateUI()
public FileChooserUI getUI()
protected String paramString()
JFileChooser
component, for use in debugging. The return
value is guaranteed to be non-null
, but the format of the
string may vary between implementations.paramString
in class JComponent
JFileChooser
.public AccessibleContext getAccessibleContext()
JFileChooser
component.getAccessibleContext
in interface Accessible
getAccessibleContext
in class JComponent
JFileChooser.AccessibleJFileChooser
).