- java.lang.Object
-
- javax.swing.filechooser.FileFilter
-
- javax.swing.filechooser.FileNameExtensionFilter
-
public final class FileNameExtensionFilter extends FileFilter
An implementation ofFileFilter
that filters using a specified set of extensions. The extension for a file is the portion of the file name after the last ".". Files whose name does not contain a "." have no file name extension. File name extension comparisons are case insensitive.The following example creates a
FileNameExtensionFilter
that will showjpg
files:FileFilter filter = new FileNameExtensionFilter("JPEG file", "jpg", "jpeg"); JFileChooser fileChooser = ...; fileChooser.addChoosableFileFilter(filter);
-
-
Constructor Summary
Constructors Constructor and Description FileNameExtensionFilter(String description, String... extensions)
Creates aFileNameExtensionFilter
with the specified description and file name extensions.
-
Method Summary
Methods Modifier and Type Method and Description boolean
accept(File f)
Tests the specified file, returning true if the file is accepted, false otherwise.String
getDescription()
The description of this filter.String[]
getExtensions()
Returns the set of file name extensions files are tested against.String
toString()
Returns a string representation of theFileNameExtensionFilter
.
-
-
-
Constructor Detail
-
FileNameExtensionFilter
public FileNameExtensionFilter(String description, String... extensions)
Creates aFileNameExtensionFilter
with the specified description and file name extensions. The returnedFileNameExtensionFilter
will accept all directories and any file with a file name extension contained inextensions
.- Parameters:
description
- textual description for the filter, may benull
extensions
- the accepted file name extensions- Throws:
IllegalArgumentException
- if extensions isnull
, empty, containsnull
, or contains an empty string- See Also:
accept(java.io.File)
-
-
Method Detail
-
accept
public boolean accept(File f)
Tests the specified file, returning true if the file is accepted, false otherwise. True is returned if the extension matches one of the file name extensions of thisFileFilter
, or the file is a directory.- Specified by:
accept
in classFileFilter
- Parameters:
f
- theFile
to test- Returns:
- true if the file is to be accepted, false otherwise
-
getDescription
public String getDescription()
The description of this filter. For example: "JPG and GIF Images."- Specified by:
getDescription
in classFileFilter
- Returns:
- the description of this filter
- See Also:
FileView.getName(java.io.File)
-
getExtensions
public String[] getExtensions()
Returns the set of file name extensions files are tested against.- Returns:
- the set of file name extensions files are tested against
-
toString
public String toString()
Returns a string representation of theFileNameExtensionFilter
. This method is intended to be used for debugging purposes, and the content and format of the returned string may vary between implementations.
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/swing/filechooser/FileNameExtensionFilter.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.