form_field(3curses)                              form_field(3curses)


       NAME
             form_field: set_form_fields, form_fields, field_count,
             move_field - connect fields to forms

       SYNOPSIS
             cc [flag . . .] file -lform -lcurses [library . . .]
             #include <form.h>
             int set_form_fields(FORM *form, FIELD **field);
             FIELD **form_fields(FORM *form);
             int field_count(FORM *Pform);
             int move_field(FIELD *field, int frow, int fcol);

       DESCRIPTION
             set_form_fields changes the fields connected to form to
             fields.  The original fields are disconnected.

             form_fields returns a pointer to the field pointer array
             connected to form.

             field_count returns the number of fields connected to form.

             move_field moves the disconnected field to the location frow,
             fcol in the forms subwindow.

       RETURN VALUE
             form_fields returns NULL on error.

             field_count returns -1 on error.

             set_form_fields and move_field return 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.
             E_POSTED         The form is posted.

       NOTICES
             The header file form.h automatically includes the header files
             eti.h and curses.h.

       REFERENCES
             curses(3curses), forms(3curses)






                           Copyright 1994 Novell, Inc.               Page 1