form_page(S)

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

Syntax

cc ... -lform -lcurses

#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(S) sets the page number of form to page. form_page(S) returns the current page number of form.

set_current_field(S) sets the current field of form to field. current_field(S) returns a pointer to the current field of form.

field_index(S) 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.

Warning

The header file form.h automatically includes the header files eti.h and curses.h.

Files

/usr/lib/libform.a: the library

Standards conformance

set_form_page(S), form_page(S), set_current_field(S), current_field(S), and field_index(S) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.

`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.