formopts(3X)                                                    formopts(3X)



NAME
       formopts - set and get form options

SYNOPSIS
       ##include <>
       int setformopts(FORM *form, OPTIONS opts);
       int formoptson(FORM *form, OPTIONS opts);
       int formoptsoff(FORM *form, OPTIONS opts);
       OPTIONS formopts(const FORM *form);

DESCRIPTION
       The  function setformopts sets all the given form's option bits (form
       option bits may be logically-OR'ed together).

       The function formoptson turns on the given option  bits,  and  leaves
       others alone.

       The  function formoptsoff turns off the given option bits, and leaves
       others alone.

       The function formopts returns the form's current option bits.

       The following options are defined (all are on by default):

       ONLOVERLOAD
            Overload the REQNEWLINE forms driver request so that calling  it
            at the end of a field goes to the next field.

       OBSOVERLOAD
            Overload  the REQDELPREV forms driver request so that calling it
            at the beginning of a field goes to the previous field.

RETURN VALUE
       Except for formopts, each routine returns one of the following:

       EOK The routine succeeded.

       ESYSTEMEROR
            System error occurred (see errno).

SEE ALSO
       curses(3X), form(3X).

NOTES
       The  header  file  <>  automatically  includes  the  header  file
       <>.

PORTABILITY
       These  routines emulate the System V forms library.  They were not sup-
       ported on Version 7 or BSD versions.

AUTHORS
       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
       Raymond.



                                                                 formopts(3X)