org.hkijena.jipipe.extensions.settings

Class FileChooserSettings

java.lang.Object

org.hkijena.jipipe.extensions.settings.FileChooserSettings

All Implemented Interfaces:

JIPipeParameterCollection

public class FileChooserSettings
extends Object
implements JIPipeParameterCollection

Settings concerning file dialogs

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FileChooserSettings.FileChooserType
static class	FileChooserSettings.LastDirectoryKey

Nested classes/interfaces inherited from interface org.hkijena.jipipe.api.parameters.JIPipeParameterCollection

JIPipeParameterCollection.ParameterChangedEvent, JIPipeParameterCollection.ParameterStructureChangedEvent, JIPipeParameterCollection.ParameterUIChangedEvent

Field Summary

Fields

Modifier and Type	Field and Description
static String	ID

Constructor Summary

Constructors

Constructor and Description
FileChooserSettings()

Method Summary

Modifier and Type	Method and Description
PathList	getBookmarks()
EventBus	getEventBus() Gets the event bus that posts events about the parameters
FileChooserSettings.FileChooserType	getFileChooserType()
static FileChooserSettings	getInstance()
Path	getLastDataDirectory()
Path	getLastDirectoryBy(FileChooserSettings.LastDirectoryKey key) Gets the last directory by key
Path	getLastExternalDirectory()
Path	getLastParametersDirectory()
Path	getLastProjectsDirectory()
boolean	isAddFileExtension()
static List<Path>	openDirectories(Component parent, FileChooserSettings.LastDirectoryKey key, String title) Lets the user choose multiple directories
static Path	openDirectory(Component parent, FileChooserSettings.LastDirectoryKey key, String title) Lets the user choose a directory
static Path	openFile(Component parent, FileChooserSettings.LastDirectoryKey key, String title, FileNameExtensionFilter... extensionFilters) Lets the user choose a file
static List<Path>	openFiles(Component parent, FileChooserSettings.LastDirectoryKey key, String title) Lets the user choose multiple files
static Path	openPath(Component parent, FileChooserSettings.LastDirectoryKey key, String title) Lets the user choose a file or directory
static List<Path>	openPaths(Component parent, FileChooserSettings.LastDirectoryKey key, String title) Lets the user choose multiple files or directories
static Path	saveDirectory(Component parent, FileChooserSettings.LastDirectoryKey key, String title) Lets the user choose a directory
static Path	saveFile(Component parent, FileChooserSettings.LastDirectoryKey key, String title, FileNameExtensionFilter... extensionFilters) Lets the user choose a file
static Path	savePath(Component parent, FileChooserSettings.LastDirectoryKey key, String title) Lets the user choose a file or directory
static List<Path>	selectMulti(Component parent, FileChooserSettings.LastDirectoryKey key, String title, PathIOMode ioMode, PathType pathMode) Generic open method for multiple paths.
static Path	selectSingle(Component parent, FileChooserSettings.LastDirectoryKey key, String title, PathIOMode ioMode, PathType pathMode, FileNameExtensionFilter... extensionFilters) Generic open/save method for single paths
void	setAddFileExtension(boolean addFileExtension)
void	setBookmarks(PathList bookmarks)
void	setFileChooserType(FileChooserSettings.FileChooserType fileChooserType)
void	setLastDataDirectory(Path lastDataDirectory)
void	setLastDirectoryBy(FileChooserSettings.LastDirectoryKey key, Path lastDirectory) Sets the last directory according to the key
void	setLastExternalDirectory(Path lastExternalDirectory)
void	setLastParametersDirectory(Path lastParametersDirectory)
void	setLastProjectsDirectory(Path lastProjectsDirectory)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.hkijena.jipipe.api.parameters.JIPipeParameterCollection

addParameterChangeListener, addParameterChangeListener, getContextActions, getParameter, getParameterAccess, isParameterUIVisible, isParameterUIVisible, setParameter, triggerParameterChange, triggerParameterStructureChange, triggerParameterUIChange

Field Detail

ID

public static String ID

Constructor Detail

FileChooserSettings

public FileChooserSettings()

Method Detail

openFile

public static Path openFile(Component parent,
                            FileChooserSettings.LastDirectoryKey key,
                            String title,
                            FileNameExtensionFilter... extensionFilters)

Lets the user choose a file

Parameters:

parent - parent component

key - location where the dialog is opened

title - dialog title

extensionFilters - optional extension filters. the first one is chosen automatically

Returns:

selected file or null if dialog was cancelled

saveFile

public static Path saveFile(Component parent,
                            FileChooserSettings.LastDirectoryKey key,
                            String title,
                            FileNameExtensionFilter... extensionFilters)

Lets the user choose a file

Parameters:

parent - parent component

key - location where the dialog is opened

title - dialog title

extensionFilters - extension filters. the first one is chosen automatically

Returns:

selected file or null if dialog was cancelled

openPath

public static Path openPath(Component parent,
                            FileChooserSettings.LastDirectoryKey key,
                            String title)

Lets the user choose a file or directory

Parameters:

parent - parent component

key - location where the dialog is opened

title - dialog title

Returns:

selected file or null if dialog was cancelled

savePath

public static Path savePath(Component parent,
                            FileChooserSettings.LastDirectoryKey key,
                            String title)

Lets the user choose a file or directory

Parameters:

parent - parent component

key - location where the dialog is opened

title - dialog title

Returns:

selected file or null if dialog was cancelled

openDirectory

public static Path openDirectory(Component parent,
                                 FileChooserSettings.LastDirectoryKey key,
                                 String title)

Lets the user choose a directory

Parameters:

parent - parent component

key - location where the dialog is opened

title - dialog title

Returns:

selected directory or null if dialog was cancelled

saveDirectory

public static Path saveDirectory(Component parent,
                                 FileChooserSettings.LastDirectoryKey key,
                                 String title)

Lets the user choose a directory

Parameters:

parent - parent component

key - location where the dialog is opened

title - dialog title

Returns:

selected directory or null if dialog was cancelled

openFiles

public static List<Path> openFiles(Component parent,
                                   FileChooserSettings.LastDirectoryKey key,
                                   String title)

Lets the user choose multiple files

Parameters:

parent - parent component

key - location where the dialog is opened

title - dialog title

Returns:

selected list of files. Is empty if dialog was cancelled.

openDirectories

public static List<Path> openDirectories(Component parent,
                                         FileChooserSettings.LastDirectoryKey key,
                                         String title)

Lets the user choose multiple directories

Parameters:

parent - parent component

key - location where the dialog is opened

title - dialog title

Returns:

selected list of files. Is empty if dialog was cancelled.

openPaths

public static List<Path> openPaths(Component parent,
                                   FileChooserSettings.LastDirectoryKey key,
                                   String title)

Lets the user choose multiple files or directories

Parameters:

parent - parent component

key - location where the dialog is opened

title - dialog title

Returns:

selected list of files. Is empty if dialog was cancelled.

selectSingle

public static Path selectSingle(Component parent,
                                FileChooserSettings.LastDirectoryKey key,
                                String title,
                                PathIOMode ioMode,
                                PathType pathMode,
                                FileNameExtensionFilter... extensionFilters)

Generic open/save method for single paths

Parameters:

parent - parent component

key - location where the dialog is opened

title - dialog title

ioMode - whether to load or save

pathMode - which types of paths are returned

extensionFilters - passed if a file is opened/saved

Returns:

selected path of provided pathMode or null if dialog was cancelled

selectMulti

public static List<Path> selectMulti(Component parent,
                                     FileChooserSettings.LastDirectoryKey key,
                                     String title,
                                     PathIOMode ioMode,
                                     PathType pathMode)

Generic open method for multiple paths. Info: Due to API limitations, only one saved file can be returned.

Parameters:

parent - parent component

key - location where the dialog is opened

title - dialog title

ioMode - whether to load or save

pathMode - which types of paths are returned

Returns:

selected paths of provided pathMode or empty list if dialog was cancelled

getInstance

public static FileChooserSettings getInstance()

getEventBus

public EventBus getEventBus()

Description copied from interface: JIPipeParameterCollection

Gets the event bus that posts events about the parameters

Specified by:

getEventBus in interface JIPipeParameterCollection

Returns:

The event bus triggering JIPipeParameterCollection.ParameterChangedEvent and JIPipeParameterCollection.ParameterStructureChangedEvent

getBookmarks

public PathList getBookmarks()

setBookmarks

public void setBookmarks(PathList bookmarks)

getFileChooserType

public FileChooserSettings.FileChooserType getFileChooserType()

setFileChooserType

public void setFileChooserType(FileChooserSettings.FileChooserType fileChooserType)

getLastDirectoryBy

public Path getLastDirectoryBy(FileChooserSettings.LastDirectoryKey key)

Gets the last directory by key

Parameters:

key - the key

Returns:

the last path or Paths.get() (home directory)

setLastDirectoryBy

public void setLastDirectoryBy(FileChooserSettings.LastDirectoryKey key,
                               Path lastDirectory)

Sets the last directory according to the key

Parameters:

key - the key

lastDirectory - directory or file

getLastExternalDirectory

public Path getLastExternalDirectory()

setLastExternalDirectory

public void setLastExternalDirectory(Path lastExternalDirectory)

getLastProjectsDirectory

public Path getLastProjectsDirectory()

setLastProjectsDirectory

public void setLastProjectsDirectory(Path lastProjectsDirectory)

getLastParametersDirectory

public Path getLastParametersDirectory()

setLastParametersDirectory

public void setLastParametersDirectory(Path lastParametersDirectory)

getLastDataDirectory

public Path getLastDataDirectory()

setLastDataDirectory

public void setLastDataDirectory(Path lastDataDirectory)

isAddFileExtension

public boolean isAddFileExtension()

setAddFileExtension

public void setAddFileExtension(boolean addFileExtension)