swingutils.dialogs.filechooser

Contains helpers for JFileChooser related functionality.

class swingutils.dialogs.filechooser.SimpleFileFilter(suffixes, preferred=None, description=None)

A simple FileFilter class, suitable for use with the showSaveDialog() function, and of course Java’s JFileChooser class.

swingutils.dialogs.filechooser.createFileChooserDialog(filters, filename, prefs, prefkey, multiselect)

Creates a file chooser dialog that remembers its last directory.

swingutils.dialogs.filechooser.showOpenDialog(filters, filename=None, parent=None, prefs=None, prefkey=None, multiselect=False)

Shows a save dialog that remembers the last directory based on the given preferences key. If the selected file filter has a ‘suffix’ attribute, it will be appended to the selected file name if it’s missing.

Parameters:

• filters (javax.swing.filechooser.FileFilter) – a FileFilter (or several of them in an iterable)
• filename (str) – default name for the new file
• parent – parent component to attach to
• prefs (java.util.prefs.Preferences) – a Preferences object to use for remembering the save directory
• prefkey (str) – key to use for saving/loading last save directory
• multiselect – True to allow multiple files to be selected

Returns:

list of selected files (if multiselect=True), else the selected file

Return type:

java.io.File

swingutils.dialogs.filechooser.showSaveDialog(filters, filename=None, parent=None, prefs=None, prefkey=None)

Shows a save dialog that remembers the last directory based on the given preferences key. If the selected file filter has a ‘suffix’ attribute, it will be appended to the selected file names if it’s missing.

Parameters:

• filters (javax.swing.filechooser.FileFilter) – a FileFilter (or several of them in an iterable)
• filename (str) – default name for the new file
• parent – parent component to attach to
• prefs (java.util.prefs.Preferences) – a Preferences object to use for remembering the save directory
• prefkey (str) – key to use for saving/loading last save directory

Returns:

the selected file

Return type:

java.io.File