form_field_new(3X)      LIBRARY FUNCTIONS      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 con-
     tents 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 attri-
     butes  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).









                                                                1