JFileChooser

Overview

Package

Class

Tree

Deprecated

Index

Help

Codase Click

search sample or example code,

search definition,

search google

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.swing
Class JFileChooser

java.lang.Object   
  java.awt.Component   
      java.awt.Container   
          javax.swing.JComponent   
              javax.swing.JFileChooser

All Implemented Interfaces:: ImageObserver , MenuContainer , Serializable , Accessible

public class JFileChooser
extends JComponent
implements Accessible
extends JComponent
implements Accessible

JFileChooser provides a simple mechanism for the user to choose a file. For information about using JFileChooser, see How to Use File Choosers, a section in The Java Tutorial.

The following code pops up a file chooser for the user's home directory that sees only .jpg and .gif images:

    JFileChooser chooser = new JFileChooser();
    // Note: source for ExampleFileFilter can be found in FileChooserDemo,
    // under the demo/jfc directory in the JDK.
    ExampleFileFilter filter = new ExampleFileFilter();
    filter.addExtension("jpg");
    filter.addExtension("gif");
    filter.setDescription("JPG & GIF Images");
    chooser.setFileFilter(filter);
    int returnVal = chooser.showOpenDialog(parent);
    if(returnVal == JFileChooser.APPROVE_OPTION) {
       System.out.println("You chose to open this file: " +
            chooser.getSelectedFile().getName());
    }

See Also:: Serialized Form

Nested Class Summary
`protected class`	`JFileChooser.AccessibleJFileChooser` This class implements accessibility support for the `JFileChooser` class.

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.BltBufferStrategy , Component.FlipBufferStrategy`

Field Summary
`static String`	`ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY` Identifies whether a the AcceptAllFileFilter is used or not.
`protected AccessibleContext`	`accessibleContext`
`static String`	`ACCESSORY_CHANGED_PROPERTY` Says that a different accessory component is in use (for example, to preview files).
`static String`	`APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY` Identifies change in the mnemonic for the approve (yes, ok) button.
`static String`	`APPROVE_BUTTON_TEXT_CHANGED_PROPERTY` Identifies change in the text on the approve (yes, ok) button.
`static String`	`APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY` Identifies change in the tooltip text for the approve (yes, ok) button.
`static int`	`APPROVE_OPTION` Return value if approve (yes, ok) is chosen.
`static String`	`APPROVE_SELECTION` Instruction to approve the current selection (same as pressing yes or ok).
`static int`	`CANCEL_OPTION` Return value if cancel is chosen.
`static String`	`CANCEL_SELECTION` Instruction to cancel the current selection.
`static String`	`CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY` Identifies a change in the list of predefined file filters the user can choose from.
`static String`	`CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY` Instruction to display the control buttons.
`static int`	`CUSTOM_DIALOG` Type value indicating that the `JFileChooser` supports a developer-specified file operation.
`static String`	`DIALOG_TITLE_CHANGED_PROPERTY` Identifies a change in the dialog title.
`static String`	`DIALOG_TYPE_CHANGED_PROPERTY` Identifies a change in the type of files displayed (files only, directories only, or both files and directories).
`static int`	`DIRECTORIES_ONLY` Instruction to display only directories.
`static String`	`DIRECTORY_CHANGED_PROPERTY` Identifies user's directory change.
`static int`	`ERROR_OPTION` Return value if an error occured.
`static String`	`FILE_FILTER_CHANGED_PROPERTY` User changed the kind of files to display.
`static String`	`FILE_HIDING_CHANGED_PROPERTY` Identifies a change in the display-hidden-files property.
`static String`	`FILE_SELECTION_MODE_CHANGED_PROPERTY` Identifies a change in the kind of selection (single, multiple, etc.).
`static String`	`FILE_SYSTEM_VIEW_CHANGED_PROPERTY` Says that a different object is being used to find available drives on the system.
`static String`	`FILE_VIEW_CHANGED_PROPERTY` Says that a different object is being used to retrieve file information.
`static int`	`FILES_AND_DIRECTORIES` Instruction to display both files and directories.
`static int`	`FILES_ONLY` Instruction to display only files.
`static String`	`MULTI_SELECTION_ENABLED_CHANGED_PROPERTY` Enables multiple-file selections.
`static int`	`OPEN_DIALOG` Type value indicating that the `JFileChooser` supports an "Open" file operation.
`static int`	`SAVE_DIALOG` Type value indicating that the `JFileChooser` supports a "Save" file operation.
`static String`	`SELECTED_FILE_CHANGED_PROPERTY` Identifies change in user's single-file selection.
`static String`	`SELECTED_FILES_CHANGED_PROPERTY` Identifies change in user's multiple-file selection.

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
`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
`JFileChooser ()` Constructs a `JFileChooser` pointing to the user's default directory.
`JFileChooser (File currentDirectory)` Constructs a `JFileChooser` using the given `File` as the path.
`JFileChooser (File currentDirectory, FileSystemView fsv)` Constructs a `JFileChooser` using the given current directory and `FileSystemView`.
`JFileChooser (FileSystemView fsv)` Constructs a `JFileChooser` using the given `FileSystemView`.
`JFileChooser (String currentDirectoryPath)` Constructs a `JFileChooser` using the given path.
`JFileChooser (String currentDirectoryPath, FileSystemView fsv)` Constructs a `JFileChooser` using the given current directory path and `FileSystemView`.

Method Summary
`boolean`	`accept (File f)` Returns true if the file should be displayed.
`void`	`addActionListener (ActionListener l)` Adds an `ActionListener` to the file chooser.
`void`	`addChoosableFileFilter (FileFilter filter)` Adds a filter to the list of user choosable file filters.
`void`	`approveSelection ()` Called by the UI when the user hits the Approve button (labeled "Open" or "Save", by default).
`void`	`cancelSelection ()` Called by the UI when the user chooses the Cancel button.
`void`	`changeToParentDirectory ()` Changes the directory to be set to the parent of the current directory.
`protected JDialog`	`createDialog (Component parent)` Creates and returns a new `JDialog` wrapping `this` centered on the `parent` in the `parent`'s frame.
`void`	`ensureFileIsVisible (File f)` Makes sure that the specified file is viewable, and not hidden.
`protected void`	`fireActionPerformed (String command)` Notifies all listeners that have registered interest for notification on this event type.
`FileFilter`	`getAcceptAllFileFilter ()` Returns the `AcceptAll` file filter.
`AccessibleContext`	`getAccessibleContext ()` Gets the AccessibleContext associated with this JFileChooser.
`JComponent`	`getAccessory ()` Returns the accessory component.
`ActionListener []`	`getActionListeners ()` Returns an array of all the action listeners registered on this file chooser.
`int`	`getApproveButtonMnemonic ()` Returns the approve button's mnemonic.
`String`	`getApproveButtonText ()` Returns the text used in the `ApproveButton` in the `FileChooserUI`.
`String`	`getApproveButtonToolTipText ()` Returns the tooltip text used in the `ApproveButton`.
`FileFilter []`	`getChoosableFileFilters ()` Gets the list of user choosable file filters.
`boolean`	`getControlButtonsAreShown ()` Returns the value of the `controlButtonsAreShown` property.
`File`	`getCurrentDirectory ()` Returns the current directory.
`String`	`getDescription (File f)` Returns the file description.
`String`	`getDialogTitle ()` Gets the string that goes in the `JFileChooser`'s titlebar.
`int`	`getDialogType ()` Returns the type of this dialog.
`boolean`	`getDragEnabled ()` Gets the value of the `dragEnabled` property.
`FileFilter`	`getFileFilter ()` Returns the currently selected file filter.
`int`	`getFileSelectionMode ()` Returns the current file-selection mode.
`FileSystemView`	`getFileSystemView ()` Returns the file system view.
`FileView`	`getFileView ()` Returns the current file view.
`Icon`

javax.swing Class JFileChooser

javax.swing
Class JFileChooser