[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    form_page(3X) manual page Table of Contents

Name

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

Synopsis

cc [ flag ... ] file ... -lform -lcurses [ 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);

MT-Level

Unsafe

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 Values

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.

See Also

curses(3X) , forms(3X)

Notes

The header <form.h> automatically includes the headers <eti.h> and <curses.h>.

Table of Contents