2 <BODY BGCOLOR="#99ccbb" TEXT="#000000" LINK="#4060b0" VLINK="#000080" ALINK="#ff4040">
4 <STRONG>form_new_page</STRONG> - form pagination functions
9 <STRONG>#include</STRONG> <STRONG><form.h></STRONG>
10 int set_new_page(FIELD *field, bool new_page_flag);
11 bool new_page(const FIELD *field);
15 <H2>DESCRIPTION</H2><PRE>
16 The function <STRONG>set_new_page</STRONG> sets or resets a flag marking
17 the given field as the beginning of a new page on its
20 The function <STRONG>new_page</STRONG> is a predicate which tests if a
21 given field marks a page beginning on its form.
25 <H2>RETURN VALUE</H2><PRE>
26 The function <STRONG>new_page</STRONG> returns <STRONG>TRUE</STRONG> or <STRONG>FALSE</STRONG>.
28 The function <STRONG>set_new_page</STRONG> return one of the following:
30 <STRONG>E_OK</STRONG> The routine succeeded.
32 <STRONG>E_SYSTEM_ERROR</STRONG>
33 System error occurred (see <STRONG>errno</STRONG>).
35 <STRONG>E_CONNECTED</STRONG>
36 The given field is already connected to a form.
40 <H2>SEE ALSO</H2><PRE>
41 <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG> and 3X pages whose names begin "form_" for
42 detailed descriptions of the entry points.
47 The header file <STRONG><form.h></STRONG> automatically includes the header
48 file <STRONG><curses.h></STRONG>.
52 <H2>PORTABILITY</H2><PRE>
53 These routines emulate the System V forms library. They
54 were not supported on Version 7 or BSD versions.
59 Juergen Pfeifer. Manual pages and adaptation for new
60 curses by Eric S. Raymond.