NAME

       fsdialog - dialog boxes for the user to select a file or directory.

SYNOPSIS

       package require Tk  8.6.6

       package require fsdialog  1.0

       ttk::fsdialog configfile ?name?

       ttk::fsdialog history ?name ...?

       ttk::fsdialog preferences ?option? ?value option value ...?

_________________________________________________________________________________________________

DESCRIPTION

       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::fsdialog configfile ?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::fsdialog history ?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::fsdialog preferences ?option? ?value option value ...?
              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:

              details boolean
                     Show the short (0) or long (1) version of the file list. Default: 0.

              duopane boolean
                     Combine  files and directories in a single pane (0) or show directories in a
                     separate pane (1). Default: 0.

              hidden boolean
                     Show hidden files and directories. Default: 0.

              mixed boolean
                     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.

              reverse boolean
                     Show the entries in reverse sorting order. Default: 0.

              sort property
                     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.

COPYRIGHT

       Copyright (c) 2018 Schelte Bron