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(5) for descriptions of the following attributes:

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

SEE ALSO

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

NOTES

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

SunOS 5.11							    31 Dec 1996 					       form_field(3CURSES)