Dialog(3I) InterViews Reference Manual Dialog(3I)NAME
Dialog - popup dialog interactor
SYNOPSIS
#include <InterViews/dialog.h>
DESCRIPTION
A dialog is an interactor that handles input for a dialog box. The dialog layout is specified by a separate interactor passed to the dia-
log constructor. The dialog completes when the value of an associated button state becomes non-zero. This button state is typically set
by one or more buttons in the component interactor.
PUBLIC OPERATIONS
Dialog(ButtonState*, Interactor*, Alignment = Center)
Construct a new dialog with the given button state and interactor. The alignment is used by the Popup operation.
virtual boolean Accept()
Set the dialog button state to zero and loop reading events until the button state's value becomes non-zero. Each event is passed
to is target's Handle operation. Return true if the value is one, false otherwise.
virtual boolean Popup(Event&, boolean placed = true)
Insert the dialog into the world associated with the given event. If placed is true, align the dialog around the event's (x, y)
coordinate. Otherwise, the dialog is inserted without specifying a position. Popup then calls the Accept operation and returns its
value.
SEE ALSO Button(3I), Interactor(3I), World(3I)InterViews 11 August 1988 Dialog(3I)
Check Out this Related Man Page
FileChooser(3I) InterViews Reference Manual FileChooser(3I)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, sub-
title, or PushButton instances. This constructor should be called in subclasses requiring a specialized StringEditor or File-
Browser.
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, File-
Browser size specification, and pop-up alignment without composing them into the default layout and without creating the title, sub-
title, 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)