form_field(3X) form_field(3X) NAME form_field - make and break connections between fields and forms SYNOPSIS #include <form.h> int set_form_fields(FORM *form, FIELD **fields); FIELD **form_fields(const FORM *form); int field_count(const FORM *form); int move_field(FIELD *field, int frow, int fcol); DESCRIPTION The function set_form_fields changes the field pointer array of the given form. The array must be terminated by a NULL. The function form_fields returns the field array of the given form. The function field_count returns the count of fields in(1,8) form. The function move_field moves the given field (which must be discon- nected) to a specified location on the screen. RETURN VALUES The function form_fields returns NULL on error. The function field_count returns ERR (the general curses error(8,n) return value) on error. The functions set_form_fields and move_field return one of the follow- ing codes on error: E_OK The routine succeeded. E_SYSTEM_ERROR System error(8,n) occurred (see errno). E_BAD_ARGUMENT Routine detected an incorrect or out-of-range argument. E_POSTED The form is already posted. E_CONNECTED The field is already connected to a form. SEE ALSO curses(3X), form(3X). NOTES The header file(1,n) <form.h> automatically includes the header file(1,n) <curses.h>. PORTABILITY These routines emulate the System V forms library. They were not sup- ported on Version 7 or BSD versions. The SVr4 forms library documentation specifies the field_count error(8,n) value as -1 (which is the value of ERR). AUTHORS Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. form_field(3X)