AT&T UNIX™PC Unix System V Users Manual - tenox

FORM ( 3T ) ( AT&T UNIX PC only ) FORM ( 3T )
NAME
form - display and accept forms
SYNOPSIS
#include
#include
int fo rm( form, op)
form_t *form;
int op;
DESCRIPTION
This routine manipulates a form as determined by the operation
code ( op ) . If the op arg is F _BEGIN, the form is initialized and
displayed. If op is F _INPUT, user input is accepted. If op is
F _END, the form is terminated and removed from the display.
These functions may be combined in many ways. By specifying
(F _BEGIN IF _INPUT IF _END), the caller creates a "pop-up"
form which is initialized (displayed), used for input, then removed.
Generally, (F _BEGIN IF _INPUT) is used for the first call,
F _INPUT for each subsequent interaction, and F _END when the
form is to be discarded.
During the F _INPUT function, the user may point to fields with
the mouse or with the keyboard (arrows, Prev, Next, Beg, Home,
End, Tab). The user may may modify fields by typing and editing
(Back Space, Dlete Char, Clear Line, Cancel) or by selecting a
choice from a menu optionally associated with the field.
The form structure has the following form:
typedef struct
{
char
char
char
int
track_t
field_t
field_t
} form_t;
*f_label;
*f_name;
f_fl.ags;
f_win;
*f_track;
*f_fields;
*f_curfl;
I* form label *I
I* form name *I
I* form flags *I
I* form window *I
I* tracking info *I
I* fields *I
I* current field *I
F_label is the form label, displayed on the window label line of
the form. If /_label is NULL, no label is displayed.
F _name is the form name, or NULL if the form has no name.
F _flags contains flags. The F _ WINNEW flag causes form to use
the "new " algorithm to place the window. Basically, the new algorithm
looks for relatively empty screen space to place the window.
F_WINSON causes form to use the "son" algorithm which causes
the new window to slightly overlap the current window. If neither
F _ WINNEW nor F _WINSON is given, the "popup" algorithm is
used. This causes the new window to appear near the middle of
the current window, inside it if possible. F _NO MOVE is set if the
- 1 -