FORM_PAGE(3CURSES) Curses Library Functions FORM_PAGE(3CURSES)

NAME

form_page, set_form_page, set_current_field, current_field,
field_index - set forms current page and field

SYNOPSIS

cc [ flag... ] file... -lform -lcurses [ library... ]
#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 VALUES

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

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+

SEE ALSO

curses(3CURSES), forms(3CURSES), attributes(7)

NOTES

The header <form.h> automatically includes the headers <eti.h> and
<curses.h>.

December 31, 1996 FORM_PAGE(3CURSES)