The fsdialog package installs direct replacements for the original tk_getOpenFile, tk_getSaveFile, and
tk_chooseDirectory commands of Tk. The replacements provide more advanced features for user interaction.
See the manual pages of the original commands for the details on their usage.
To control the advanced features, the package provides some additional commands.
ttk::fsdialogconfigfile ?name?
Specify a configuration file for the dialogs to automatically store and retrieve the preference
settings and history. By default, the package will use the file ".config/tcltk/fsdialog.cfg", but
only if that file exists. Calling this command without the name argument will create the default
configuration file, so it is guaranteed to be used. Specify an empty string for name to prevent
the use of the default configuration file, even if it exists.
ttk::fsdialoghistory ?name...?
Get or seed the list of files and directories that will be presented to the user in various drop-
down lists. That list is normally maintained automatically, but this command makes it available
for external storage and loading.
ttk::fsdialogpreferences ?option? ?valueoptionvalue...?
Configure preference settings. This command is provide for situations where the use of a specific
configuration file for the file system dialogs is not desired. For example, when the preferences
are going to be stored as part of the overall application configuration.
If no name or value arguments are supplied, the command returns a list containing alternating
option names and values for the channel. If name is supplied but no value then the command returns
the current value of the given option. If one or more pairs of name and value are supplied, the
command sets each of the named options to the corresponding value; in this case the return value
is an empty string.
The following settings are available:
detailsboolean
Show the short (0) or long (1) version of the file list. Default: 0.
duopaneboolean
Combine files and directories in a single pane (0) or show directories in a separate pane
(1). Default: 0.
hiddenboolean
Show hidden files and directories. Default: 0.
mixedboolean
List directories before files (0) or list all entries without making a distinction between
files and directories (1). This setting only has effect when files and directories are
shown in a single pane. Default: 0.
reverseboolean
Show the entries in reverse sorting order. Default: 0.
sortproperty
Select which property to use for sorting the entries in the file pane. The directory pane
is always sorted by name. Possible values are name, date, and size. Default: name.