Generated by
JDiff

javax.swing.filechooser Documentation Differences

This file contains all the changes in documentation in the package javax.swing.filechooser as colored differences. Deletions are shown like this, and additions are shown like this.
If no deletions or additions are shown in an entry, the HTML tags will be what has changed. The new HTML tags are shown in the differences. If no documentation existed, and then some was added in a later version, this change is noted in the appropriate class pages of differences, but the change is not shown on this page. Only changes in existing text are shown here. Similarly, documentation which was inherited from another class or interface is not shown here.
Note that an HTML error in the new documentation may cause the display of other documentation changes to be presented incorrectly. For instance, failure to close a <code> tag will cause all subsequent paragraphs to be displayed differently.

Class FileFilter

FileFilter is an abstract class that has no default implementionimplementation. A FileFilter once implemented can be set on a JFileChooser to keep unwanted files from appearing in the directory listing. For an example implementation of a simple file filter see yourSDK/demo/jfc/FileChooserDemo/ExampleFileFilter.java. For more information and examples see How to Use File Choosers a section in The Java Tutorial. @see javax.swing.JFileChooser#setFileFilter @see javax.swing.JFileChooser#addChoosableFileFilter @version 1.14 0216 12/0203/0001 @author Jeff Dinkins

Class FileSystemView

FileSystemView is JFileChooser's gateway to the file system. Since the JDK1.1 File apiAPI doesn't allow access to such information as root partitianspartitions file type information or hidden file bits this class is designed to intuit as much OS -specific file system information as possible. FileSystemView will eventually delegate its responsibilities to io File classes when JDK1.X provides more direct access to file system information.

Java LicensesLicensees may want to provide a different implemenationimplementation of FileSystemView to better handle a given operation system. PENDING(jeff) - need to provide a specification for how Mac/OS2/BeOS/etc file systems can modify FileSystemView to handle their particular type of fileoperating system. @version 1.15 0234 12/2003/01 @author Jeff Dinkins

Class FileSystemView, File createNewFolder(File)

createsCreates a new folder with a default folder name.
Class FileSystemView, File[] getFiles(File, boolean)

getsGets the list of shown (i.e. not hidden) files.
Class FileSystemView, File getParentDirectory(File)

Returns the parent directory of dir. @param dir the File being queried @return the parent directory of dir or null if dir is null
Class FileSystemView, File[] getRoots()

Returns all root partitianspartitions on this system. For example on Windows this would be the "Desktop" folder while on DOS this would be the A: through Z: drives.
Class FileSystemView, boolean isRoot(File)

Determines if the given file is a root partitionin orthe navigatable tree(s). Examples: Windows 98 has one root the Desktop folder. DOS has one root per drive letter C:\ D:\ etc. Unix has one root the "/" directory. The default implementation gets information from the ShellFolder class. @param f a File object representing a directory @return true if f is a root in the navigatable tree. @see #isFileSystemRoot

Class FileView

FileView defines an abstract class that can be implemented to provide the filechooser with ui information for a File. Each L&F JFileChooserUI object implements this class to pass back the correct icons and type descriptions specific to that L&F. For example the Windows L&F returns the generic Windows icons for directories and generic files. Additionally you may want to provide your own FileView to JFileChooser to return different icons or additional information using javax.swing.JFileChooser#setFileView

JFileChooser first looks to see if there is a user defined FileView if there is it gets type information from there first. If FileView returns null for any method JFileChooser then uses the L&F specific view to get the information. So for example if you provide a FileView class that returns an Icon for JPG files and returns null icons for all other files the UI's FileView will provide default icons for all other files.

For an example implementation of a simple file filter see yourSDK/demo/jfc/FileChooserDemo/ExampleFileView.java. For more information and examples see How to Use File Choosers a section in The Java Tutorial. @see javax.swing.JFileChooser @version 1.14 0215 12/0203/0001 @author Jeff Dinkins