FileChooser - dialog box for choosing a file name

SYNOPSIS

       #include <InterViews/filechooser.h>

DESCRIPTION

       FileChooser  is  a  StringChooser that provides a complete
       dialog box interface to selecting a file name.  The inter-
       face   consists  of  two  lines  of  descriptive  text,  a
       StringEditor for entering  the  file  name  explicitly,  a
       FileBrowser,  and  two  PushButtons, one for accepting and
       one for canceling the dialog.

PUBLIC OPERATIONS

       FileChooser(const char* title, const char* subtitle, const
              char*          dir, int rows, int cols, const char*
              acceptLabel, Alignment)
       FileChooser(const  char*  name,  const  char*, const
              char*, const   char*, int, int, const char* accept,
              Alignment)
              Construct a new FileChooser with  the  given  title
              and  subtitle,  search  directory  dir, FileBrowser
              size specification rows and  cols,  label  for  the
              accept  PushButton  acceptLabel,  and pop-up align-
              ment.  These constructors create all  the  elements
              of  the  dialog box and compose them into a default
              layout.

       void SetTitle(const char*)
       void SetSubtitle(const char*)
              Change the text in title or the subtitle.  The  new
              text  will  appear  immediately  in the dialog when
              either function is called.

       void SelectFile()
              Highlight the text in the StringEditor.

       void Update()
              FileChooser's Update simply  calls  Update  on  the
              FileBrowser  instance  to rescan the current direc-
              tory and update its appearance.

PROTECTED OPERATIONS

       FileChooser(ButtonState*, Alignment = Center)
              Construct a new FileChooser with the  given  button
              state  and  pop-up alignment without creating File-
              Browser, StringEditor, title, subtitle, or PushBut-
              ton  instances.   This constructor should be called
              in subclasses requiring a specialized  StringEditor
              or FileBrowser.

       FileChooser(ButtonState*,  const  char*  dir, int rows,
              StringEditor and its FileBrowser)  with  the  given
              button  state,  search  directory, FileBrowser size
              specification, and pop-up alignment without compos-
              ing them into the default layout and without creat-
              ing the title, subtitle, or PushButtons. This  con-
              structor  should  be used by FileChooser subclasses
              that define a specialized look and feel.

SEE ALSO

       Button(3I),    Dialog(3I),    FileBrowser(3I),     String-
       Chooser(3I), StringEditor(3I)