form_page(3ocurses)


form_page: set_form_page, form_page, set_current_field, current_field, field_index -- set forms current page and field

Synopsis

cc [flag . . .] file -lform -locurses [library . . .]

#include <form.h>

int set_form_page(FORM *form, int page); int form_page(FORM *form); int set_current_field(FORM *form, FIELD *field); FIELD *current_field(FORM *form); int field_index(FIELD *field);

Description

set_form_page sets the page number of form to page. form_page returns the current page number of form.

set_current_field sets the current field of form to field. current_field returns a pointer to the current field of form.

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

<Return> value

form_page returns -1 on error.

current_field returns NULL on error.

field_index returns -1 on error.

set_form_page and set_current_field 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.

 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.

Notices

The header file form.h automatically includes the header files eti.h and ocurses.h.

References

curses(3ocurses), forms(3ocurses)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004