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)