org.simbrain.util

Class SFileChooser

java.lang.Object

org.simbrain.util.SFileChooser

public class SFileChooser
extends java.lang.Object

SFileChooser extends java's JFileChooser, providing for automatic adding of file extensions, memory of file-locations, and checks to prevent file-overwrites. 2008-10-09 Matt Watson - modified to support new serialization approach more easily.

Constructor Summary

Constructors

Constructor and Description
SFileChooser(java.lang.String currentDirectory, java.lang.String description) Creates file chooser dialog.
SFileChooser(java.lang.String currentDirectory, java.lang.String description, java.lang.String extension) Creates the file chooser dialog.

Method Summary

Modifier and Type	Method and Description
void	addExtension(java.lang.String extension) Adds an extension with the default description to the filenamefilter.
void	addExtension(java.lang.String description, java.lang.String extension) Adds an extension with the provided description to the filenamefilter.
boolean	confirmOverwrite(java.io.File file) Ask user whether to overwrite the give existing file.
java.lang.String	getCurrentLocation() Returns the directory this chooser is in.
static java.lang.String	getExtension(java.io.File theFile) Returns all the characters after the last period in the file name.
static java.lang.String	getExtension(java.lang.String fileName) Returns all the characters after the last period in the file name.
void	setUseImagePreview(boolean useViewer) Sets the file chooser to use image preview viewer.
java.io.File	showOpenDialog() Shows dialog for opening files.
java.io.File	showSaveDialog() Shows the save dialog.
java.io.File	showSaveDialog(java.io.File file) Shows dialog for saving files.
java.io.File	showSaveDialog(java.lang.String file) Shows the save dialog for the given string name.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SFileChooser

public SFileChooser(java.lang.String currentDirectory,
                    java.lang.String description)

Creates file chooser dialog.

Parameters:

currentDirectory - Open and save directory

description - the description for the full set of extensions

SFileChooser

public SFileChooser(java.lang.String currentDirectory,
                    java.lang.String description,
                    java.lang.String extension)

Creates the file chooser dialog. Use this constructor when only one extension is supported.

Parameters:

currentDirectory - Open and save directory

description - a description of the extension

extension - File type extension for open and save

Method Detail

addExtension

public void addExtension(java.lang.String description,
                         java.lang.String extension)

Adds an extension with the provided description to the filenamefilter.

Parameters:

extension - the extension

description - the description

addExtension

public void addExtension(java.lang.String extension)

Adds an extension with the default description to the filenamefilter.

Parameters:

extension - the extension to add

showOpenDialog

public java.io.File showOpenDialog()

Shows dialog for opening files.

Returns:

File if selected

showSaveDialog

public java.io.File showSaveDialog(java.io.File file)

Shows dialog for saving files.

Parameters:

file -

Returns:

Name of file saved

confirmOverwrite

public boolean confirmOverwrite(java.io.File file)

Ask user whether to overwrite the give existing file.

Parameters:

file - the file in question

Returns:

whether the user selected "yes"

showSaveDialog

public java.io.File showSaveDialog(java.lang.String file)

Shows the save dialog for the given string name.

Parameters:

file - the name of the file

Returns:

the file name to save to

showSaveDialog

public java.io.File showSaveDialog()

Shows the save dialog.

Returns:

the selected file

getExtension

public static java.lang.String getExtension(java.io.File theFile)

Returns all the characters after the last period in the file name.

Parameters:

theFile - the file

Returns:

all the characters after the last period in the file name

getExtension

public static java.lang.String getExtension(java.lang.String fileName)

Returns all the characters after the last period in the file name.

Parameters:

fileName - the file's name

Returns:

all the characters after the last period in the file name

getCurrentLocation

public java.lang.String getCurrentLocation()

Returns the directory this chooser is in.

Returns:

the directory this chooser is in.

setUseImagePreview

public void setUseImagePreview(boolean useViewer)

Sets the file chooser to use image preview viewer.

Parameters:

useViewer - use image preview viewer.