form_field_new(3X)                                       form_field_new(3X)


   NAME
         formfieldnew:  newfield, dupfield, linkfield, freefield, -
         create and destroy forms fields

   SYNOPSIS
         #include <form.h>

         FIELD *newfield(int r, int c, int frow, int fcol,
               int nrow, int ncol);
         FIELD *dupfield(FIELD *field, int frow, int fcol);
         FIELD *linkfield(FIELD *field, int frow, int fcol);
         int freefield(FIELD *field);

   DESCRIPTION
         newfield creates a new field with r rows and c columns, starting at
         frow, fcol, in the subwindow of a form.  nrow is the number of off-
         screen rows and nbuf is the number of additional working buffers.
         This routine returns a pointer to the new field.

         dupfield duplicates field at the specified location.  All field
         attributes are duplicated, including the current contents of the
         field buffers.

         linkfield also duplicates field at the specified location.  However,
         unlike dupfield, the new field shares the field buffers with the
         original field.  After creation, the attributes of the new field can
         be changed without affecting the original field.

         freefield frees the storage allocated for field.

   RETURN VALUE
         Routines that return pointers return NULL on error.  freefield
         returns one of the following:
         EOK           - The function returned successfully.
         ECONNECTED    - The field is already connected to a form.
         ESYSTEMERROR - System error.
         EBADARGUMENT - An argument is incorrect.

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

   SEE ALSO
         forms(3X).









   8/91                                                                 Page 1