FORM_FIELD(3CURSES) Curses Library Functions FORM_FIELD(3CURSES)

NAME

form_field, set_form_fields, form_fields, field_count, move_field -
connect fields to forms

SYNOPSIS

cc [ flag... ] file... -lform -lcurses [ library... ]
#include <form.h>

int set_form_fields(FORM *form, FIELD **field);


FIELD **form_fields(FORM *form);


int field_count(FORM *form);


int move_field(FIELD *field, int frow, int fcol);

DESCRIPTION

set_form_fields() changes the fields connected to form to fields. The
original fields are disconnected.


form_fields() returns a pointer to the field pointer array connected
to form.


field_count() returns the number of fields connected to form.


move_field() moves the disconnected field to the location frow, fcol
in the forms subwindow.

RETURN VALUES

form_fields() returns NULL on error.


field_count() returns -1 on error.


set_form_fields() and move_field() return one of the following:

E_OK
The function returned successfully.


E_CONNECTED
The field is already connected to a form.


E_SYSTEM_ERROR
System error.


E_BAD_ARGUMENT
An argument is incorrect


E_POSTED
The form is posted.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+

SEE ALSO

curses(3CURSES), forms(3CURSES), attributes(7)

NOTES

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

December 31, 1996 FORM_FIELD(3CURSES)