FileChooser(3)
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.