Curses Library Functions                  formfieldnew(3CURSES)



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

SYNOPSIS
     cc [ flag... ] file... -lform  -lcurses  [ library... ]
     #include 

     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  loca-
     tion.  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 VALUES
     Routines  that  return  pointers  return  NUL   on   error.
     freefield() returns one of the following:

     EOK              Thefunction returned successfully.


     ECONECTED       The field is already connected to a form.





SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                  formfieldnew(3CURSES)



     ESYSTEMEROR    System error.


     EBADARGUMENT    An argument is incorrect.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     curses(3CURSES), forms(3CURSES), attributes(5)

NOTES
     The  header    automatically  includes  the  headers
      and .






























SunOS 5.11          Last change: 31 Dec 1996                    2