Swing JFileChooser Class

Advertisements


Introduction

The class JFileChooser is a component which provides a simple mechanism for the user to choose a file.

Class declaration

Following is the declaration for javax.swing.JFileChooser class:

public class JFileChooser
   extends JComponent
      implements Accessible

Field

Following are the fields for javax.swing.JFileChooser class:

  • 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.

Class constructors

S.N.Constructor & Description
1JFileChooser()
Constructs a JFileChooser pointing to the user's default directory.
2JFileChooser(File currentDirectory)
Constructs a JFileChooser using the given File as the path.
3JFileChooser(File currentDirectory, FileSystemView fsv)
Constructs a JFileChooser using the given current directory and FileSystemView.
4JFileChooser(FileSystemView fsv)
Constructs a JFileChooser using the given FileSystemView.
5JFileChooser(String currentDirectoryPath)
Constructs a JFileChooser using the given path.
6JFileChooser(String currentDirectoryPath, FileSystemView fsv)
Constructs a JFileChooser using the given current directory path and FileSystemView.

Class methods

S.N.Method & Description
1boolean accept(File f)
Returns true if the file should be displayed.
2void addActionListener(ActionListener l)
Adds an ActionListener to the file chooser.
3void addChoosableFileFilter(FileFilter filter)
Adds a filter to the list of user choosable file filters.
4void approveSelection()
Called by the UI when the user hits the Approve button (labeled "Open" or "Save", by default).
5void cancelSelection()
Called by the UI when the user chooses the Cancel button.
6void changeToParentDirectory()
Changes the directory to be set to the parent of the current directory.
7protected JDialog createDialog(Component parent)
Creates and returns a new JDialog wrapping this centered on the parent in the parent's frame.
8void ensureFileIsVisible(File f)
Makes sure that the specified file is viewable, and not hidden.
9protected void fireActionPerformed(String command)
Notifies all listeners that have registered interest for notification on this event type.
10FileFilter getAcceptAllFileFilter()
Returns the AcceptAll file filter.
11AccessibleContext getAccessibleContext()
Gets the AccessibleContext associated with this JFileChooser.
12JComponent getAccessory()
Returns the accessory component.
13ActionListener[] getActionListeners()
Returns an array of all the action listeners registered on this file chooser.
14int getApproveButtonMnemonic()
Returns the approve button's mnemonic.
15String getApproveButtonText()
Returns the text used in the ApproveButton in the FileChooserUI.
16String getApproveButtonToolTipText()
Returns the tooltip text used in the ApproveButton.
17FileFilter[] getChoosableFileFilters()
Gets the list of user choosable file filters.
18boolean getControlButtonsAreShown()
Returns the value of the controlButtonsAreShown property.
19File getCurrentDirectory()
Returns the current directory.
20String getDescription(File f)
Returns the file description.
21String getDialogTitle()
Gets the string that goes in the JFileChooser's titlebar.
22int getDialogType()
Returns the type of this dialog.
23boolean getDragEnabled()
Gets the value of the dragEnabled property.
24FileFilter getFileFilter()
Returns the currently selected file filter.
25int getFileSelectionMode()
Returns the current file-selection mode.
26FileSystemView getFileSystemView()
Returns the file system view.
27FileView getFileView()
Returns the current file view.
28Icon getIcon(File f)
Returns the icon for this file or type of file, depending on the system.
29String getName(File f)
Returns the filename.
30File getSelectedFile()
Returns the selected file.
31File[] getSelectedFiles()
Returns a list of selected files if the file chooser is set to allow multiple selection.
32String getTypeDescription(File f)
Returns the file type.
33FileChooserUI getUI()
Gets the UI object which implements the L&F for this component.
34String getUIClassID()
Returns a string that specifies the name of the L&F class that renders this component.
35boolean isAcceptAllFileFilterUsed()
Returns whether the AcceptAll FileFilter is used.
36boolean isDirectorySelectionEnabled()
Convenience call that determines if directories are selectable based on the current file selection mode.
37boolean isFileHidingEnabled()
Returns true if hidden files are not shown in the file chooser; otherwise, returns false.
38boolean isFileSelectionEnabled()
Convenience call that determines if files are selectable based on the current file selection mode.
39boolean isMultiSelectionEnabled()
Returns true if multiple files can be selected.
40boolean isTraversable(File f)
Returns true if the file (directory) can be visited.
41protected String paramString()
Returns a string representation of this JFileChooser.
42void removeActionListener(ActionListener l)
Removes an ActionListener from the file chooser.
43boolean removeChoosableFileFilter(FileFilter f)
Removes a filter from the list of user choosable file filters.
44void rescanCurrentDirectory()
Tells the UI to rescan its files list from the current directory.
45void resetChoosableFileFilters()
Resets the choosable file filter list to its starting state.
46void setAcceptAllFileFilterUsed(boolean b)
Determines whether the AcceptAll FileFilter is used as an available choice in the choosable filter list.
47void setAccessory(JComponent newAccessory)
Sets the accessory component.
48void setApproveButtonMnemonic(char mnemonic)
Sets the approve button's mnemonic using a character.
49void setApproveButtonMnemonic(int mnemonic)
Sets the approve button's mnemonic using a numeric keycode.
50void setApproveButtonText(String approveButtonText)
Sets the text used in the ApproveButton in the FileChooserUI.
51void setApproveButtonToolTipText(String toolTipText)
Sets the tooltip text used in the ApproveButton.
52void setControlButtonsAreShown(boolean b)
Sets the property that indicates whether the approve and cancel buttons are shown in the file chooser.
53void setCurrentDirectory(File dir)
Sets the current directory.
54void setDialogTitle(String dialogTitle)
Sets the string that goes in the JFileChooser window's title bar.
55void setDialogType(int dialogType)
Sets the type of this dialog.
56void setDragEnabled(boolean b)
Sets the dragEnabled property, which must be true to enable automatic drag handling (the first part of drag and drop) on this component.
57void setFileFilter(FileFilter filter)
Sets the current file filter.
58void setFileHidingEnabled(boolean b)
Sets file hiding on or off.
59void setFileSelectionMode(int mode)
Sets the JFileChooser to allow the user to just select files, just select directories, or select both files and directories.
60void setFileSystemView(FileSystemView fsv)
Sets the file system view that the JFileChooser uses for accessing and creating file system resources, such as finding the floppy drive and getting a list of root drives.
61void setFileView(FileView fileView)
Sets the file view to used to retrieve UI information, such as the icon that represents a file or the type description of a file.
62void setMultiSelectionEnabled(boolean b)
Sets the file chooser to allow multiple file selections.
63void setSelectedFile(File file)
Sets the selected file.
64void setSelectedFiles(File[] selectedFiles)
Sets the list of selected files if the file chooser is set to allow multiple selection.
65protected void setup(FileSystemView view)
Performs common constructor initialization and setup.
66int showDialog(Component parent, String approveButtonText)
Pops a custom file chooser dialog with a custom approve button.
67int showOpenDialog(Component parent)
Pops up an "Open File" file chooser dialog.
68int showSaveDialog(Component parent)
Pops up a "Save File" file chooser dialog.
69void updateUI()
Resets the UI property to a value from the current look and feel.

Methods inherited

This class inherits methods from the following classes:

  • javax.swing.JComponent

  • java.awt.Container

  • java.awt.Component

  • java.lang.Object

JFileChooser Example

Create the following java program using any editor of your choice in say D:/ > SWING > com > tutorialspoint > gui >

SwingControlDemo.java
package com.tutorialspoint.gui;
 
import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
 
public class SwingControlDemo {
    
   private JFrame mainFrame;
   private JLabel headerLabel;
   private JLabel statusLabel;
   private JPanel controlPanel;

   public SwingControlDemo(){
      prepareGUI();
   }

   public static void main(String[] args){
      SwingControlDemo  swingControlDemo = new SwingControlDemo();      
      swingControlDemo.showFileChooserDemo();
   }

   private void prepareGUI(){
      mainFrame = new JFrame("Java Swing Examples");
      mainFrame.setSize(400,400);
      mainFrame.setLayout(new GridLayout(3, 1));
      mainFrame.addWindowListener(new WindowAdapter() {
         public void windowClosing(WindowEvent windowEvent){
            System.exit(0);
         }        
      });    
      headerLabel = new JLabel("", JLabel.CENTER);        
      statusLabel = new JLabel("",JLabel.CENTER);    

      statusLabel.setSize(350,100);

      controlPanel = new JPanel();
      controlPanel.setLayout(new FlowLayout());

      mainFrame.add(headerLabel);
      mainFrame.add(controlPanel);
      mainFrame.add(statusLabel);
      mainFrame.setVisible(true);  
   }

   private void showFileChooserDemo(){
      headerLabel.setText("Control in action: JFileChooser"); 

      final JFileChooser  fileDialog = new JFileChooser();
      JButton showFileDialogButton = new JButton("Open File");
      showFileDialogButton.addActionListener(new ActionListener() {
         @Override
         public void actionPerformed(ActionEvent e) {
            int returnVal = fileDialog.showOpenDialog(mainFrame);
            if (returnVal == JFileChooser.APPROVE_OPTION) {
               java.io.File file = fileDialog.getSelectedFile();
               statusLabel.setText("File Selected :" 
               + file.getName());
            }
            else{
               statusLabel.setText("Open command cancelled by user." );           
            }      
         }
      });
      controlPanel.add(showFileDialogButton);
      mainFrame.setVisible(true);  
   }
}

Compile the program using command prompt. Go to D:/ > SWING and type the following command.

D:\SWING>javac com\tutorialspoint\gui\SwingControlDemo.java

If no error comes that means compilation is successful. Run the program using following command.

D:\SWING>java com.tutorialspoint.gui.SwingControlDemo

Verify the following output

Swing JFileChooser

Advertisements
Advertisements