form_field_opts(3X)                                     form_field_opts(3X)


   NAME
         formfieldopts:  setfieldopts, fieldoptson, fieldoptsoff,
         fieldopts - forms field option routines

   SYNOPSIS
         #include <form.h>
         int setfieldopts(FIELD *field, OPTIONS opts);
         int fieldoptson(FIELD *field, OPTIONS opts);
         int fieldoptsoff(FIELD *field, OPTIONS opts);
         OPTIONS fieldopts(FIELD *field);

   DESCRIPTION
         setfieldopts turns on the named options of field and turns off all
         remaining options.  Options are boolean values that can be OR-ed
         together.

         fieldoptson turns on the named options; no other options are
         changed.

         fieldoptsoff turns off the named options; no other options are
         changed.

         fieldopts returns the options set for field.
         Field Options:
         OVISIBLE      The field is displayed.
         OACTIVE       The field is visited during processing.
         OPUBLIC       The field contents are displayed as data is entered.
         OEDIT         The field can be edited.
         OWRAP         Words not fitting on a line are wrapped to the next line.
         OBLANK        The whole field is cleared if a character is entered in the
                        first position.
         OAUTOSKIP     Skip to the next field when the current field becomes full.
         ONULLOK       A blank field is considered valid.
         OSTATIC       The field buffers are fixed in size.
         OPASSOK       Validate field only if modified by user.

   RETURN VALUE
         setfieldopts, fieldoptson and fieldoptsoff return one of the
         following:
         EOK           - The function returned successfully.
         ESYSTEMERROR - System error.
         ECURRENT      - 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).




   7/91                                                                 Page 1