NAME

       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 interface 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
              alignment.   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
              directory 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
              FileBrowser, StringEditor, title, subtitle, or PushButton instances.  This constructor  should  be
              called in subclasses requiring a specialized StringEditor or FileBrowser.

       FileChooser(ButtonState*, const char* dir, int rows, int cols, Alignment)
              Construct  a  new  FileChooser  (along  with  its StringEditor and its FileBrowser) with the given
              button state, search directory, FileBrowser  size  specification,  and  pop-up  alignment  without
              composing  them  into the default layout and without creating the title, subtitle, or PushButtons.
              This constructor should be used by FileChooser subclasses that define a specialized look and feel.

SEE ALSO

       Button(3I), Dialog(3I), FileBrowser(3I), StringChooser(3I), StringEditor(3I)

InterViews                                      30 November 1989                                 FileChooser(3I)