FORM_FIELD_OPTS(3CURSES) Curses Library Functions FORM_FIELD_OPTS(3CURSES)
NAME
form_field_opts, set_field_opts, field_opts_on, field_opts_off,
field_opts - forms field option routines
SYNOPSIS
cc [
flag... ]
file...
-lform -lcurses [
library... ]
#include <form.h>
int set_field_opts(
FIELD *field,
OPTIONS opts);
int set_field_opts(
FIELD *field,
OPTIONS opts);
int field_opts_on(
FIELD *field,
OPTIONS opts);
int field_opts_off(
FIELD *field,
OPTIONS opts);
OPTIONS field_opts(
FIELD *field);
DESCRIPTION
set_field_opts() turns on the named options of
field and turns off
all remaining options. Options are boolean values that can be OR-ed
together.
field_opts_on() turns on the named options; no other options are
changed.
field_opts_off() turns off the named options; no other options are
changed.
field_opts() returns the options set for
field.
O_VISIBLE The field is displayed.
O_ACTIVE The field is visited during processing.
O_PUBLIC The field contents are displayed as data is entered.
O_EDIT The field can be edited.
O_WRAP Words not fitting on a line are wrapped to the next
line.
O_BLANK The whole field is cleared if a character is entered in
the first position.
O_AUTOSKIP Skip to the next field when the current field becomes
full.
O_NULLOK A blank field is considered valid.
O_STATIC The field buffers are fixed in size.
O_PASSOK Validate field only if modified by user.
RETURN VALUES
set_field_opts,
field_opts_on and
field_opts_off return one of the
following:
E_OK The function returned successfully.
E_SYSTEM_ERROR System error.
E_CURRENT The field is the current field.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+
SEE ALSO
curses(3CURSES),
forms(3CURSES),
attributes(7)NOTES
The header
<form.h> automatically includes the headers
<eti.h> and
<curses.h>.
December 31, 1996 FORM_FIELD_OPTS(3CURSES)
