%NAME: Bruce M. Corwin
%COMP: Bruce M. Corwin
%PROG: vtclib
%DATE: 1995
%CODE: browse.c vtedit.c vtclib.c vtclib.h
%FUNC: program
This program is used to demonstrate how vtclib is used to write applications
that access the Motif widget features and image features of the Vt widget.
%FUNC: main
This routine initializes the vtwidget for managing widgets without selection
active or a border or the normal scrollbar.
%FUNC: display_elements
This routine is used to display all the nessesary widgets for the demonstration
application.
%FUNC: wsize
This routine queries the current standard input file descriptor to find the
number of rows and columns of the screen.
%FUNC: manage_mode
This routine sends the Vt widget into a mode where it acts like a specialized
manager widget.  It no longer has a border, a cursor, selection or a scrollbar.
This is used for most applications.  This is done by calling set_value 4 times
and disabling the appropriat flags.
%FUNC: normal_mode
This routine sends the Vt widget into the normal interactive mode where it has
a border, a cursor, selection and a scrollbar.  This is called when an
application is finished.
%FUNC: clear
This routine clears and homes the cursor.
%FUNC: destroy_all_widgets
This routine as its name implies destroys all child widgets and clears them
from the screen.
%FUNC: set_value
This routine is used to set a resource for the active Vt widget.  This routine
can radicaly change the function of the Vt widget.
%FUNC: child_set_value
This routine is used to set a resource for the specified child widget.  This routine
can radicaly change the function of the child widget.
%FUNC: create_widget
This routine creates a new child widget for the Vt widget.  It needs an
identity character to be used to 'print' the new widget on the Vt widget.  This
identity is then used by the display_widget routine.
%FUNC: display_widget
This routine is used to specify a row and column for a specified created widget
that is then printed to the screen.
%FUNC: register_button
This routine is used to define what text will be used to output data back from
a button when it is pressed.
%FUNC: noecho
Turns off the echo stty state of standard input.
%FUNC: echo
Turns on the echo stty state of standard input.
%FUNC: terminate
This routine is called when a control C is pressed while in vtinput.  It sets
a global flag that tells the vtinput routine to output a QUIT string to the
input parser.
%FUNC: find_size
This routine is called when a resize signal is caught.  It sets a global flag
that tells the vtinput routine to output a RESIZE string to the input parser.
%FUNC: resize_widget
This routine is called whenever a widget needs to be resized using normal row
column type coordinates.
%FUNC: dump_text
This routine returns a dynamicaly allocated string that has the text information from
a text widget.  This can be used to retrieve information from a text widget.  Again
this data must be freed when its use is complete.
%FUNC: append_text_raw
This routine can be used to append text to the data in a text widget.  This is useful
when data needs to be pre-loaded into a text widget.  This routine as opposed to the
append_text routine does not try to escape control characters.
%FUNC: append_list_raw
This routine can be used to append text to the data in a list widget.  This is useful
when data needs to be pre-loaded into a list widget.  This routine as opposed to the
append_list routine does not try to escape control characters.
%FUNC: append_text
This routine can be used to append text to the data in a text widget.  This is useful
when data needs to be pre-loaded into a text widget.
%FUNC: append_list
This routine can be used to append text to the data in a list widget.  This is useful
when data needs to be pre-loaded into a list widget.
%FUNC: append_file
This routine loads an entire TEXT file into a text widget.  This will not deal very well with some binary files so this kind of file should not be
used with this routine.
%FUNC: append_list_file
This routine load an entire TEXT file into a list widget.  This will not deal
very well with binary files most likely.  Obviously this is for listing only.
No editing can take place in a text widget.
%FUNC: vtset
This routine sets up the signal structure of the program to utilize vtinput
properly.
%FUNC: vtinput
This routine is used to obtain input from the various child widgets on the
current string.
%PARM: title Input
This is the title for the created dialog.
%PARM: dtext Input
This is the dialog text to display in the dialog.
%PARM: argc Input
Number of command line parameters passed from
the invoking environment
%PARM: argv Input
Array of command line parameters passed
from the invoking environment
%PARM: filename Input
File name to load.
%PARM: rows Output
Number of rows for the screen.
%PARM: columns Output
Number of columns for the screen.
%PARM: buffer Input
Buffer of characters from the input stream.
%PARM: resource Input
Resource to set the value of.
%PARM: value Input
Value to set the resource to.
%PARM: identity Input
Identity character that identifies the created widget.
%PARM: wtype Input
Type of widget to create.
%PARM: width Input
Number of columns the widget will span.
%PARM: height Input
Number of rows the widget will cover.
%PARM: name Input
Name of the widget.
%PARM: row Input
Row of widget.
%PARM: column Input
Column of widget.
%PARM: text Input
Output text for button.
%PARM: ttext Input
Data to be sent to the text widget.
%PARM: tio Input
Terminal io data structure.
%HIST: program
05-01-95    Bruce M. Corwin   Initial Release
%HIST: main
05-01-95    Bruce M. Corwin   Initial Release
%HIST: noecho
08/11/93    Bruce M. Corwin  Initial Release
%HIST: echo
08/11/93    Bruce M. Corwin  Initial Release
%FUNC: question_dialog
This routine displays a Question Dialog with the provided title and text.
%FUNC: warning_dialog
This routine displays a Warning Dialog with the provided title and text.
%FUNC: information_dialog
This routine displays an Information Dialog with the provided title and text.
%FUNC: error_dialog
This routine displays an Error Dialog with the provided title and text.
%FUNC: message_dialog
This routine displays a Message Dialog with the provided title and text.
%FUNC: working_dialog
This routine displays a Working Dialog with the provided title and text.
%FUNC: dialog_reset
This routine resets the current dialog setting of the Vt widget.
%FUNC: file_dialog
This routine displays a File Dialog with the provided title.
%HIST: question_dialog
01/07/97    Bruce M. Corwin  Initial Release
%HIST: warning_dialog
01/07/97    Bruce M. Corwin  Initial Release
%HIST: information_dialog
01/07/97    Bruce M. Corwin  Initial Release
%HIST: error_dialog
01/07/97    Bruce M. Corwin  Initial Release
%HIST: message_dialog
01/07/97    Bruce M. Corwin  Initial Release
%HIST: working_dialog
01/07/97    Bruce M. Corwin  Initial Release
%HIST: dialog_reset
01/07/97    Bruce M. Corwin  Initial Release
%HIST: file_dialog
01/07/97    Bruce M. Corwin  Initial Release
