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.

FileFilter is an abstract class that has no default implemention. A FileFilter once implemented can be set on a JFileChooser to keep unwanted files from appearing in the directory listing. A default implementation (ExtensionFileFilter) is currently in the FileChooserDemo directory and will become a first class swing implementation in Swing 1.0.3. For an example implementation of a simple file filter see yourJDKyourSDK/demo/jfc/FileChooserDemo/ExampleFileFilter.java. For more information see theand Swing Connectionexamples see articleHow on theto Use File ChooserChoosers a section in The Java Tutorial. @see javax.swing.JFileChooser#setFileFilter @see javax.swing.JFileChooser#addChoosableFileFilter @version 1.7 0814 02/2602/9800 @author Jeff Dinkins

FileSystemView is JFileChooser's gateway to the file system. Since the JDK1.1 File api doesn't allow access to such information as root partitians 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 Licenses may want to provide a different implemenation 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 file system. @version 1.12 0914 01/2221/0001 @author Jeff Dinkins

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 yourJDKyourSDK/demo/jfc/FileChooserDemo/ExampleFileView.java. For more information see theand Swing Connectionexamples see articleHow on theto Use File ChooserChoosers a section in The Java Tutorial. @see javax.swing.JFileChooser @version 1.7 0814 02/2602/9800 @author Jeff Dinkins