form_new_page(S)

form_new_page: set_new_page, new_page -- forms pagination

Syntax

cc ... -lform -lcurses

#include <form.h>

int set_new_page(FIELD *field, int bool);
int new_page(FIELD *field);

Description

set_new_page(S) marks field as the beginning of a new page on the form.

new_page(S) returns a boolean value indicating whether or not field begins a new page of the form.

Return values

new_page( ) returns TRUE or FALSE.

set_new_page( ) returns 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.

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_new_page(S) and new_page(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_CONNECTED`	-	The field is already connected to a form.
`E_SYSTEM_ERROR`	-	System error.