field_term(3) [netbsd man page]

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

NAME

     field_init, field_term, form_init, form_term, set_field_init, set_field_term, set_form_init, set_form_term -- form library

LIBRARY

     Curses Form Library (libform, -lform)

SYNOPSIS

     #include <form.h>

     void (*)(FORM *)
     field_init(FORM *form);

     void (*)(FORM *)
     field_term(FORM *form);

     void (*)(FORM *)
     form_init(FORM *form);

     void (*)(FORM *)
     form_term(FORM *form);

     int
     set_field_init(FORM *form, void (*function)(FORM *));

     int
     set_field_term(FORM *form, void (*function)(FORM *));

     int
     set_form_init(FORM *form, void (*function)(FORM *));

     int
     set_form_term(FORM *form, void (*function)(FORM *));

DESCRIPTION

     The field_init() function returns a pointer to the function that will be called just after the current field changes and just before the form
     is posted, this function may be set by using the set_field_init() function.  Similarly, the function field_term() will return a pointer to
     the function that will be called just before the current field changes and just after the form is unposted, this function pointer may be set
     by using the set_field_term() function.  The form_init() function will return a pointer to the function that will be called just before the
     form is posted to the screen, this function can be set by calling the set_form_init() function.  The form_term() function will return a
     pointer to the function that will be called just after the form is unposted from the screen, this function may be set by using the
     set_form_term() function.	By default, the init and term function pointers are NULL.

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.

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_hook(3CURSES)					     Curses Library Functions						form_hook(3CURSES)

NAME

       form_hook, set_form_init, form_init, set_form_term, form_term, set_field_init, field_init, set_field_term, field_term - assign application-
       specific routines for invocation by forms

SYNOPSIS

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

       int set_form_init(FORM *form, void (*func)(FORM*));

       void (*form_init)(FORM *form);

       int set_form_term(FORM *form, void (*func)(FORM*));

       void (*form_term)(FORM *form);

       int set_field_init(FORM *form, void (*func)(FORM*));

       void (*field_init)(FORM *form);

       int set_field_term(FORM *form, void (*func)(FORM*));

       void (*field_term)(FORM *form);

DESCRIPTION

       These routines allow the programmer to assign application specific routines to be executed automatically at initialization and  termination
       points  in the forms application. The user need not specify any application-defined initialization or termination routines at all, but they
       may be helpful for displaying messages or page numbers and other chores.

       set_form_init() assigns an application-defined initialization function to be called when the form is posted and just after a  page  change.
       form_init() returns a pointer to the initialization function, if any.

       set_form_term()	assigns  an application-defined function to be called when the form is unposted and just before a page change. form_term()
       returns a pointer to the function, if any.

       set_field_init() assigns an application-defined function to be called when the form is posted and just after  the  current  field  changes.
       field_init() returns a pointer to the function, if any.

       set_field_term()  assigns an application-defined function to be called when the form is unposted and just before the current field changes.
       field_term() returns a pointer to the function, if any.

RETURN VALUES

       Routines that return pointers always return NULL on error. Routines that return an integer return one of the following:

       E_OK		 The function returned successfully.

       E_SYSTEM_ERROR	 System error.

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_hook(3CURSES)