formfield(3X)                                                  formfield(3X)



NAME
       formfield - make and break connections between fields and forms

SYNOPSIS
       ##include <>
       int setformfields(FORM *form, FIELD **fields);
       FIELD **formfields(const FORM *form);
       int fieldcount(const FORM *form);
       int movefield(FIELD *field, int frow, int fcol);

DESCRIPTION
       The  function  setformfields  changes  the field pointer array of the
       given form.  The array must be terminated by a NUL.

       The function formfields returns the field array of the given form.

       The function fieldcount returns the count of fields in form.

       The function movefield moves the given field (which  must  be  discon-
       nected) to a specified location on the screen.

RETURN VALUES
       The function formfields returns NUL on error.

       The  function  fieldcount returns ER (the general curses error return
       value) on error.

       The functions setformfields and movefield return one of the  follow-
       ing codes on error:

       EOK The routine succeeded.

       ESYSTEMEROR
            System error occurred (see errno).

       EBADARGUMENT
            Routine detected an incorrect or out-of-range argument.

       EPOSTED
            The form is already posted.

       ECONECTED
            The field is already connected to a form.

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.

       The  SVr4  forms  library documentation specifies the fieldcount error
       value as -1 (which is the value of ER).

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



                                                                formfield(3X)