form_page(3X) — MISCELLANEOUS LIBRARY FUNCTIONS
NAME
form_page: set_form_page, form_page, set_current_field, current_field, field_index − set forms current page and field
SYNOPSIS
#include <form.h>
int set_form_page(FORM ∗form, int page);
int form_page(FORM ∗form);
int set_current_field(FORM ∗form, FIELD ∗field);
FIELD ∗current_field(FORM ∗form);
int field_index(FIELD ∗field);
DESCRIPTION
set_form_page sets the page number of form to page. form_page returns the current page number of form.
set_current_field sets the current field of form to field. current_field returns a pointer to the current field of form.
field_index returns the index in the field pointer array of field.
RETURN VALUE
form_page returns -1 on error.
current_field returns NULL on error.
field_index returns -1 on error.
set_form_page and set_current_field return one of the following:
| E_OK | − | The function returned successfully. | |
| E_SYSTEM_ERROR | − | System error. | |
| E_BAD_ARGUMENT | − | An argument is incorrect. | |
| E_BAD_STATE | − | The routine was called from an initialization | |
| or termination function. | |||
| E_INVALID_FIELD | − | The field contents are invalid. | |
| E_REQUEST_DENIED | − | The form driver request failed. |
NOTES
The header file form.h automatically includes the header files eti.h and curses.h.