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(5) for descriptions of the following attributes:

See Also

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

Notes

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