form_field_new(3X)                SDK R4.11               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).


Licensed material--property of copyright holder(s)