NAME

form_field_opts: set_field_opts, field_opts_on, field_opts_off, field_opts - forms field option routines

SYNOPSIS

#include <form.h>

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.
Field Options:
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 VALUE

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.

NOTES

The header file <form.h> automatically includes the header files <eti.h> and <curses.h>.

SEE ALSO

curses(3X), forms(3X).