formpage(3X) formpage(3X)

NAME
       ffoorrmmppaaggee - set and get form page number

SYNOPSIS
       ##iinncclluuddee <>
       int setcurrentfield(FORM *form, FIELD *field);
       FIELD *currentfield(const FORM *);
       int setformpage(FORM *form, int n);
       int formpage(const FORM *form);
       int fieldindex(const FIELD *field);

DESCRIPTION
       The  function  sseettccuurrrreenntt  ffiieelldd  sets  the current field of the given
       form; ccuurrrreennttffiieelldd returns the current field of the given form.

       The function sseettffoorrmmppaaggee sets the form's page number (goes to page  n
       of the form).

       The function ffoorrmmppaaggee returns the form's current page number.

       The  function  ffiieellddiinnddeexx  returns the index of the field in the field
       array of the form it is connected to. It returns EERRRR if the argument is
       the null pointer or the field is not connected.

RREETTUURRNN VVAALLUUEE
       Except for ffoorrmmppaaggee, each routine returns one of the following:

       EEOOKK The routine succeeded.

       EESSYYSSTTEEMMEERRRROORR
            System error occurred (see eerrrrnnoo).

       EEBBAADDAARRGGUUMMEENNTT
            Routine detected an incorrect or out-of-range argument.

       EEBBAADDSSTTAATTEE
            Routine was called from an initialization or termination function.

       EEIINNVVAALLIIDDFFIIEELLDD
            Contents of a field are not valid.

       EERREEQQUUEESSTTDDEENNIIEEDD
            The form driver could not process the request.

SEE ALSO
       ccuurrsseess(3X), ffoorrmm(3X).

NNOOTTEESS
       The  header  file  <>  automatically  includes  the  header  file
       <>.

PPOORRTTAABBIILLIITTYY
       These  routines emulate the System V forms library.  They were not sup-
       ported on Version 7 or BSD versions.

AUTHORS       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
       Raymond.



                                                                 formpage(3X)