form_page(3X)    MISCELLANEOUS LIBRARY FUNCTIONS    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  fol-
     lowing:
     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).







                          Last change:                          1