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)