form_hook(3X)    MISCELLANEOUS LIBRARY FUNCTIONS    form_hook(3X)



NAME
     formhook:    setforminit,    forminit,    setformterm,
     formterm,   setfieldinit,   fieldinit,   setfieldterm,
     fieldterm - assign application-specific routines for  invo-
     cation by forms

SYNOPSIS
     #include <form.h>

     int setforminit(FORM *form, void (*func)(FORM *));
     void (*)(FORM *) forminit(FORM *form);

     int setformterm(FORM *form, void (*func)(FORM *));
     void (*)(FORM *) formterm(FORM *form);
     int setfieldinit(FORM *form, void (*func)(FORM *));
     void (*)(FORM *) fieldinit(FORM *form);

     int setfieldterm(FORM *form, void (*func)(FORM *));
     void (*)(FORM *) fieldterm(FORM *form);

DESCRIPTION
     These routines allow the  programer  to  assign  application
     specific  routines to be executed automatically at initiali-
     zation 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.

     setforminit assigns an application-defined  initialization
     function to be called when the form is posted and just after
     a page change.  forminit returns a pointer to the initiali-
     zation function, if any.

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

     setfieldinit assigns an application-defined function to be
     called  when  the  form is posted and just after the current
     field changes.  fieldinit returns a pointer  to  the  func-
     tion, if any.

     setfieldterm assigns an application-defined function to be
     called when the form is unposted and just before the current
     field changes.  fieldterm returns a pointer  to  the  func-
     tion, if any.

RETURN VALUE
     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.



                          Last change:                          1

form_hook(3X)    MISCELLANEOUS LIBRARY FUNCTIONS    form_hook(3X)



NOTES
     The header file <form.h> automatically includes  the  header
     files <eti.h> and <curses.h>.

SEE ALSO
     curses(3X), forms(3X).

















































                          Last change:                          2