motris.gui
Class SimpleFileFilter

java.lang.Object
  extended byjavax.swing.filechooser.FileFilter
      extended bymotris.gui.SimpleFileFilter

public class SimpleFileFilter
extends javax.swing.filechooser.FileFilter

A convenience implementation of FileFilter that filters out all files except for those type extensions that it knows about. Extensions are of the type ".foo", which is typically found on Windows and Unix boxes, but not on Macinthosh. Case is ignored. Simple - create a new filter that filerts out all files but gif and jpg image files: JFileChooser chooser = new JFileChooser(); SimpleFileFilter filter = new SimpleFileFilter( new String{"gif", "jpg"}, "JPEG & GIF Images") chooser.addChoosableFileFilter(filter); chooser.showOpenDialog(this);

Version:
1.13 06/13/02
Author:
Jeff Dinkins

Field Summary
private  java.lang.String description
           
private  java.util.Hashtable filters
           
private  java.lang.String fullDescription
           
private static java.lang.String HIDDEN_FILE
           
private static java.lang.String TYPE_UNKNOWN
           
private  boolean useExtensionsInDescription
           
 
Constructor Summary
SimpleFileFilter()
          Creates a file filter.
SimpleFileFilter(java.lang.String extension)
          Creates a file filter that accepts files with the given extension.
SimpleFileFilter(java.lang.String[] filters)
          Creates a file filter from the given string array.
SimpleFileFilter(java.lang.String[] filters, java.lang.String description)
          Creates a file filter from the given string array and description.
SimpleFileFilter(java.lang.String extension, java.lang.String description)
          Creates a file filter that accepts the given file type.
 
Method Summary
 boolean accept(java.io.File f)
          Return true if this file should be shown in the directory pane, false if it shouldn't.
 void addExtension(java.lang.String extension)
          Adds a filetype "dot" extension to filter against.
 java.lang.String getDescription()
          Returns the human readable description of this filter.
 java.lang.String getExtension(java.io.File f)
          Return the extension portion of the file's name .
 boolean isExtensionListInDescription()
          Returns whether the extension list (.jpg, .gif, etc) should show up in the human readable description.
 void setDescription(java.lang.String description)
          Sets the human readable description of this filter.
 void setExtensionListInDescription(boolean b)
          Determines whether the extension list (.jpg, .gif, etc) should show up in the human readable description.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

TYPE_UNKNOWN

private static java.lang.String TYPE_UNKNOWN

HIDDEN_FILE

private static java.lang.String HIDDEN_FILE

filters

private java.util.Hashtable filters

description

private java.lang.String description

fullDescription

private java.lang.String fullDescription

useExtensionsInDescription

private boolean useExtensionsInDescription
Constructor Detail

SimpleFileFilter

public SimpleFileFilter()
Creates a file filter. If no filters are added, then all files are accepted.


SimpleFileFilter

public SimpleFileFilter(java.lang.String extension)
Creates a file filter that accepts files with the given extension. Simple: new SimpleFileFilter("jpg");


SimpleFileFilter

public SimpleFileFilter(java.lang.String extension,
                        java.lang.String description)
Creates a file filter that accepts the given file type. Simple: new SimpleFileFilter("jpg", "JPEG MotrisImage Images"); Note that the "." before the extension is not needed. If provided, it will be ignored.


SimpleFileFilter

public SimpleFileFilter(java.lang.String[] filters)
Creates a file filter from the given string array. Simple: new SimpleFileFilter(String {"gif", "jpg"}); Note that the "." before the extension is not needed adn will be ignored.


SimpleFileFilter

public SimpleFileFilter(java.lang.String[] filters,
                        java.lang.String description)
Creates a file filter from the given string array and description. Simple: new SimpleFileFilter(String {"gif", "jpg"}, "Gif and JPG Images"); Note that the "." before the extension is not needed and will be ignored.

Method Detail

accept

public boolean accept(java.io.File f)
Return true if this file should be shown in the directory pane, false if it shouldn't. Files that begin with "." are ignored.


getExtension

public java.lang.String getExtension(java.io.File f)
Return the extension portion of the file's name .


addExtension

public void addExtension(java.lang.String extension)
Adds a filetype "dot" extension to filter against. For Simple: the following code will create a filter that filters out all files except those that end in ".jpg" and ".tif": SimpleFileFilter filter = new SimpleFileFilter(); filter.addExtension("jpg"); filter.addExtension("tif"); Note that the "." before the extension is not needed and will be ignored.


getDescription

public java.lang.String getDescription()
Returns the human readable description of this filter. For Simple: "JPEG and GIF MotrisImage Files (*.jpg, *.gif)"


setDescription

public void setDescription(java.lang.String description)
Sets the human readable description of this filter. For Simple: filter.setDescription("Gif and JPG Images");


setExtensionListInDescription

public void setExtensionListInDescription(boolean b)
Determines whether the extension list (.jpg, .gif, etc) should show up in the human readable description. Only relevent if a description was provided in the constructor or using setDescription();


isExtensionListInDescription

public boolean isExtensionListInDescription()
Returns whether the extension list (.jpg, .gif, etc) should show up in the human readable description. Only relevent if a description was provided in the constructor or using setDescription();