Curses Library Functions                       formhook(3CURSES)



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

SYNOPSIS
     cc [ flag... ] file... -lform  -lcurses  [ library... ]
     #include 



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


     void (*forminit)(FORM *form);


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


     void (*formterm)(FORM *form);


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


     void (*fieldinit)(FORM *form);


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


     void (*fieldterm)(FORM *form);


DESCRIPTION
     These routines allow the programmer  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  initializa-
     tion  function to be called when the form is posted and just
     after a page change. forminit() returns a  pointer  to  the
     initialization function, if any.






SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                       formhook(3CURSES)



     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
     function, if any.

RETURN VALUES
     Routines that return pointers always return NUL  on  error.
     Routines that return an integer return one of the following:

     EOK              The function returned successfully.


     ESYSTEMEROR    System error.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


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

NOTES
     The  header    automatically  includes  the  headers
      and .









SunOS 5.11          Last change: 31 Dec 1996                    2