form_page(3X)                     SDK R4.11                    form_page(3X)


NAME
       formpage:  setformpage, formpage, setcurrentfield,
       currentfield, fieldindex - set forms current page and field

SYNOPSIS
       #include <form.h>

       int setformpage(FORM *form, int page);
       int formpage(FORM *form);
       int setcurrentfield(FORM *form, FIELD *field);
       FIELD *currentfield(FORM *form);
       int fieldindex(FIELD *field);

DESCRIPTION
       setformpage sets the  page  number  of  form  to  page.   formpage
       returns the current page number of form.

       setcurrentfield   sets   the   current  field  of  form  to  field.
       currentfield returns a pointer to the current field of form.

       fieldindex returns the index in the field pointer array of field.

RETURN VALUE
       formpage returns -1 on error.

       currentfield returns NULL on error.

       fieldindex returns -1 on error.

       setformpage and setcurrentfield return one of the following:
       EOK             - The function returned successfully.
       ESYSTEMERROR   - System error.
       EBADARGUMENT   - An argument is incorrect.
       EBADSTATE      - The routine was called from an initialization
                          or termination function.
       EINVALIDFIELD  - The field contents are invalid.
       EREQUESTDENIED - The form driver request failed.

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

SEE ALSO
       curses(3X), forms(3X).


Licensed material--property of copyright holder(s)