Classes

As mentioned earlier, XFileChooser inherits from JFileChooser; check the javadocs of the JFileChooser for a list of the methods and fields in that class.

The following is a list of the methods unique to XFileChooser. For a list of variables, see "Properties".

See also the XFileChooser javadocs.

Constructors

In addition to creating the file chooser and pointing it to an initial directory, these constructors initialize some of the variables needed for using a Bean editor.

• XFileChooser()

  Creates an XFileChooser pointing to the user's home directory.

• XFileChooser(String currentDirectoryPath)

  Creates an XFileChooser pointing to the path specified by currentDirectoryPath. If currentDirectoryPath is null, the file chooser points to the user's home directory. currentDirectoryPath may be an NFS URL as specified by the Extended File API.

• XFileChooser(Xfile currentDirectory)

  Creates a file chooser that points to the directory specified by the XFile object currentDirectory.

Other Methods

• ensureFileIsVisible(Xfile xfile)

  Makes sure that the passed XFile shows up in the file list.

• getCurrentXDirectory()

  Returns an XFile object of the current directory.

• getSelectedXFile()

  Returns the XFile object of the selected file. The selected file can be set either programmatically, with setSelectedXfile(), or by the user, either by typing the filename in or choosing the file from a list.

• getSelectedXFileInputStream()

  Returns an XFileInputStream for the currently selected file.

• getSelectedXFileOutputStream()

  Returns an XFileOutputStream for the selected file.

• getSelectedXFiles()

  Returns an array of Xfile objects corresponding to the selected files.

• propertyChange(PropertyChange e)

  This method gets called when certain bound properties have changed on an associated XFileChooser. The properties it listens to include XDIRECTORY_CHANGED_PROPERTY, SELECTED_XFILE_CHANGED_PROPERTY, and SELECTED_XFILES_CHANGED_PROPERTY. This method is needed to create the corresponding XFile for the File object of the selected file or directory.

• setCurrentXDirectory(Xfile currentDirectory)

  Sets the current directory. Passing a null value sets the file chooser to point to the user's home directory. If currentDirectory is not actually a directory, its parent directory will be used as the current directory. If the parent is not traversable, then it will walk up the parent tree until it finds a traversable directory, or hits the root of the filesystem.

• setSelectedXFile(XFile xfile)

  Sets the XFile object of the selected file. If the file's parent directory is not the current directory, it changes the current directory to the parent directory (if it is traversable). If the parent is not traversable, then it will walk up the parent tree until it finds a traversable directory, or hits the root of the filesystem.

• setSelectedXFiles(XFile selectedFiles[])

  Same as setSelectedXFile(), except that it sets a list of files, if the file chooser is set to allow multiple-file selection.