form_field(3ocurses)

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

Synopsis

cc [flag . . .] file -lform -locurses [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 ocurses.h.

References

curses(3ocurses), forms(3ocurses)

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.