 -- Class: <gtk-file-selection>
     Derives from <gtk-dialog>.

     This class defines the following slots:

     show-fileops
          Whether buttons for creating/manipulating files should be displayed

     filename
          The currently selected filename

     select-multiple
          Whether to allow multiple files to be selected

 -- Function: gtk-file-selection-new (title mchars) =>  (ret <gtk-widget>)
     Creates a new file selection dialog box. By default it will contain a <gtk-tree-view> of the application's current working directory, and a file listing. Operation buttons that allow the user to create a directory, delete files and rename files, are also present.

     title
          a message that will be placed in the file requestor's titlebar.

     ret
          the new file selection.

 -- Function: gtk-file-selection-set-filename (self <gtk-file-selection>) (filename mchars)
 -- Method: set-filename
     Sets a default path for the file requestor. If FILENAME includes a directory path, then the requestor will open with that path as its current working directory.

     This has the consequence that in order to open the requestor with a working directory and an empty filename, FILENAME must have a trailing directory separator.

     The encoding of FILENAME is preferred GLib file name encoding, which may not be UTF-8. See g-filename-from-utf8.

     filesel
          a <gtk-file-selection>.

     filename
          a string to set as the default file name.

 -- Function: gtk-file-selection-get-filename (self <gtk-file-selection>) =>  (ret mchars)
 -- Method: get-filename
     This function returns the selected filename in the GLib file name encoding. To convert to UTF-8, call g-filename-to-utf8. The returned string points to a statically allocated buffer and should be copied if you plan to keep it around.

     If no file is selected then the selected directory path is returned.

     filesel
          a <gtk-file-selection>

     ret
          currently-selected filename in the on-disk encoding.

 -- Function: gtk-file-selection-complete (self <gtk-file-selection>) (pattern mchars)
 -- Method: complete
     Will attempt to match PATTERN to a valid filenames or subdirectories in the current directory. If a match can be made, the matched filename will appear in the text entry field of the file selection dialog. If a partial match can be made, the "Files" list will contain those file names which have been partially matched, and the "Folders" list those directories which have been partially matched.

     filesel
          a <gtk-file-selection>.

     pattern
          a string of characters which may or may not match any filenames in the current directory.