Manual pages › X Window and screen libraries (3X)

form_page(3X)

set forms current page and field

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

NAME

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

SYNOPSIS

#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  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