form_page(3X)                    UNIX System V                    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:
      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.

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

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










10/89                                                                    Page 1