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

FORM(3T) (AT&T UNIX PC only ) FORM (3T)
Move icon is not to be displayed on the border of the form.
F _NOHELP is set if the Help icon is not to be displayed on the
form border.
F _win holds the window identifier associated with this form. It is
allocated on an F _BEGIN call, used on subsequent calls, and �,
deleted on an F _END call. F _track is a pointer to the mouse- \
tracking information required during form interaction. The space
for this data is allocated on F _BEGIN and freed on F _END.
F _fields points to the array of fields (see below). F _curfl points to
the current field. The caller should point J_curfl to the default
field. Form will modify J_curfl as the user moves the highlighting
around in the form. The list of fields is terminated by a field
whose fl_name is NULL.
Each field in the array pointed to by /_fi elds and J_curcl has the
following form:
typedef struct
{
char
char
char
char
char
char
char
menu_t
char
} field_t;
*fl_name;
fl_row;
fl_ncol;
fl_fcol;
fl_len;
fl_flags;
*fl_value;
*fl_menu;
*fl_prompt;
/* field name *I
I* field row *I
j* name column *I
j* field column *I
j* field length *I
I* flags *I
j* field values *I
j* assoc. menu pointer *I
j* field prompt *I
Fl_name is the field name. Fl_row is the row number on which to
display the field. Row (and column) numbers are form-relative
with 0,0 being the upper-leftmost location in the form. The form
name (!_name) is located above 0,0 so the user needn't allocate a
row for it.
Fl_ncol and flJc ol control where the field name (fl_ncol) and
field value (flJcol) are displayed. Generally, flJc ol is greater
than fl_ncol by at least the length of the field name.
Fl_len is the length of the field. See fl_value, below.
Fl_flags contains various flags which describe the field.
F _CLEARIT specifies that any previous value for the field should
be erased when the user tries to enter a new value. This is useful
for fields where user editing makes little sense. F _MONL Y means
that the only allowable input to this field is via the associated
menu (see fl_menu, below).
On call, jl_value contains the initial field value. On return, this
string is modified to contain the user-supplied value. If no editing
was performed by the user, the return value is the same as the call
value. Note that the caller must supply a pointer to a character
array at least jl_len + 1 bytes long. In addition, the caller should
place a null byte after the end of the default value. For a 30 byte
�
1
- 2-