bionic (3) FileChooser.3I.gz

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)