form_field_new(3X)               UNIX System V               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:
      E_OK           - The function returned successfully.
      E_CONNECTED    - The field is already connected to a form.
      E_SYSTEM_ERROR - System error.
      E_BAD_ARGUMENT - An argument is incorrect.

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

SEE ALSO
      forms(3X)










10/89                                                                    Page 1