move_field(3) [netbsd man page]

FORMS(3)						   BSD Library Functions Manual 						  FORMS(3)

NAME

     field_count, form_fields, move_field, set_form_fields -- form library

LIBRARY

     Curses Form Library (libform, -lform)

SYNOPSIS

     #include <form.h>

     int
     field_count(FORM *form);

     FIELD **
     form_fields(FORM *form);

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

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

DESCRIPTION

     The field_count() function returns the number of fields that are attached to the given form, if the form argument passed is NULL then
     field_count() will return -1.  The function form_fields() will return a pointer to array of attach fields for the given form, this array is
     not NULL terminated, fields may be attached to the given form by calling set_form_fields().  The fields argument in this function is a
     pointer to a NULL terminated array of fields that will be attached to the form.  If there are already fields attached to the form then they
     will be detached before the new fields are attached.  The new fields given must not be attached to any other form.  The move_field() function
     will move the given field to the location specified by frow and fcol.

RETURN VALUES

     Functions returning pointers will return NULL if an error is detected.  The functions that return an int will return one of the following
     error values:

     E_OK		The function was successful.
     E_CONNECTED	The field is connected to a form.
     E_POSTED		The form is currently posted to the screen.
     E_BAD_ARGUMENT	The function was passed a bad argument.

SEE ALSO

     curses(3), forms(3)

NOTES

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

BSD
								  January 1, 2001							       BSD

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)