field_opts, field_opts_off, field_opts_on, set_field_opts - form library
field_opts_off(FIELD *field, Form_Options options);
field_opts_on(FIELD *field, Form_Options options);
set_field_opts(FIELD *field, Form_Options options);
The function field_opts() returns the current options settings for the
given field. The field_opts_off() will turn the options given in options
off for the given field, options not specified in options will remain
unchanged. Conversely, the function field_opts_on() will turn on the
options given in options for the specified field, again, any options not
specified will remain unchanged. The options for a field may be set to a
specific set of options by calling the set_field_opts() function.
Options may only be changed if the field given is not the currently
The following options are available for a field:
O_VISIBLE The field is visible, hence is displayed when the form is
O_ACTIVE The field is active in the form, meaning that it can be visited
during form processing.
O_PUBLIC The contents of the field are echoed to the screen.
O_EDIT The contents of the field can be modified
O_WRAP The contents of the field are wrapped on a word boundary, if
this option is off then the field will be wrapped on a character
O_BLANK Blank the field on new data being entered if and only if the
field cursor is at the left hand side of the field.
O_AUTOSKIP Skip to the next field when the current field reaches it's
O_NULLOK The field is allowed to contain no data
O_STATIC The field is not dynamic, it has a fixed size.
O_PASSOK An unmodified field is allowed.
The following options are on by default for a field: O_VISIBLE, O_ACTIVE,
O_PUBLIC, O_EDIT, O_WRAP, O_BLANK, O_AUTOSKIP, O_NULLOK, O_PASSOK and
Functions returning pointers will return NULL if an error is detected.
The functions that return an int will return one of the following error
E_OK The function was successful.
E_CURRENT The field specified is the currently active one in the
The header <form.h> automatically includes both <curses.h> and <eti.h>.
BSD January 1, 2001 BSD
[ Back ]