Documentation for vtclib
API Documentation for the vtclib system
Written by Bruce M. Corwin
A. Description
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.
B. Functions List
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.
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 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.
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.
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 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.
This routine is used to set a resource for the specified child widget. This routine
can radicaly change the function of the child widget.
This routine clears and homes the cursor.
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.
This routine as its name implies destroys all child widgets and clears them
from the screen.
This routine is used to display all the nessesary widgets for the demonstration
application.
This routine is used to specify a row and column for a specified created widget
that is then printed to the screen.
Turns on the echo stty state of standard input.
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.
This routine initializes the vtwidget for managing widgets without selection
active or a border or the normal scrollbar.
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.
Turns off the echo stty state of standard input.
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.
This routine is used to define what text will be used to output data back from
a button when it is pressed.
This routine is called whenever a widget needs to be resized using normal row
column type coordinates.
This routine is used to set a resource for the active Vt widget. This routine
can radicaly change the function of the Vt widget.
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.
This routine is used to obtain input from the various child widgets on the
current string.
This routine sets up the signal structure of the program to utilize vtinput
properly.
This routine queries the current standard input file descriptor to find the
number of rows and columns of the screen.
C. API Varables List
Number of command line parameters passed from
the invoking environment
Array of command line parameters passed
from the invoking environment
Buffer of characters from the input stream.
Number of columns for the screen.
Number of rows the widget will cover.
Identity character that identifies the created widget.
Resource to set the value of.
Number of rows for the screen.
Terminal io data structure.
Data to be sent to the text widget.
Value to set the resource to.
Number of columns the widget will span.
Type of widget to create.