'\"!  tbl | mmdoc
'\"macro stdmacro
.if n .pH g3x.form_page @(#)form_page	40.3 of 12/15/89
.\" Copyright 1989 AT&T
.\" ident	"@(#)svid_ti:ti_lib/form_page	1.4"
.nr X
.if \nX=0 .ds x} form_page 3X "" "\&"
.if \nX=1 .ds x} form_page 3X ""
.if \nX=2 .ds x} form_page 3X "" "\&"
.if \nX=3 .ds x} form_page "" "" "\&"
.TH \*(x}
.SH NAME
.na
\f4form_page\f2: \f4 set_form_page\f1, \f4form_page\f1, \f4set_current_field\f1, \f4current_field\f1, \f4field_index\f1 \- set \f4forms\fP current page and field
.ad
.SH SYNOPSIS
.nf
.ft 4
#include <form.h>
.sp
int set_form_page(FORM *form, int page);
int form_page(FORM *form);
.sp 0.5
int set_current_field(FORM *form, FIELD *field);
FIELD *current_field(FORM *form);
.sp 0.5
int field_index(FIELD *field);
.ft 1
.fi
.SH DESCRIPTION
\f4set_form_page\fP sets the page number of \f2form\f1 to \f2page\f1.
\f4form_page\fP returns the current page number of \f2form\f1.
.PP
\f4set_current_field\fP sets the current field of \f2form\fP to \f2field\f1.
\f4current_field\fP returns a pointer to the current field of \f2form\f1.
.PP
\f4field_index\fP returns the index in the field pointer array of
\f2field\f1.
.SH RETURN VALUE
\f4form_page\fP returns \f4-1\fP on error.
.PP
\f4current_field\fP returns \f4NULL\fP on error.
.P
\f4field_index\fP returns \f4-1\fP on error.
.PP
\f4set_form_page\fP and
\f4set_current_field\fP return one of the following:
.TS
lfCWw(1.25i)1 c1 l .
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.
.TE
.SH NOTES
.PP
The header file \f4<form.h>\f1 automatically includes the header files
\f4<eti.h>\fP and \f4<curses.h>\fP.
.SH SEE ALSO
\f4curses\fP(3X),
\f4forms\fP(3X).
