form_field(3X) — MISCELLANEOUS LIBRARY FUNCTIONS
NAME
form_field: set_form_fields, form_fields, field_count, move_field − connect fields to forms
SYNOPSIS
#include <form.h>
int set_form_fields(FORM ∗form, FIELD ∗∗field);
FIELD ∗∗form_fields(FORM ∗form);
int field_count(FORM ∗form);
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. |
NOTES
The header file form.h automatically includes the header files eti.h and curses.h.