form_page(3CURSES) Curses Library Functions form_page(3CURSES)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);
DESCRIPTIONset_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. cur‐
rent_field() returns a pointer to the current field of form.
field_index() returns the index in the field pointer array of field.
RETURN VALUESform_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 initializa‐
tion or termination function.
E_INVALID_FIELD The field contents are invalid.
E_REQUEST_DENIED The form driver request failed
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │Unsafe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOcurses(3CURSES), forms(3CURSES), attributes(5)NOTES
The header <form.h> automatically includes the headers <eti.h> and
<curses.h>.
SunOS 5.10 31 Dec 1996 form_page(3CURSES)