menu_hook(3X)                                                 menu_hook(3X)


   NAME
         menuhook: setiteminit, iteminit, setitemterm, itemterm,
         setmenuinit, menuinit, setmenuterm, menuterm - assign
         application-specific routines for automatic invocation by menus

   SYNOPSIS
         #include <menu.h>

         int setiteminit(MENU *menu, void (*func)(MENU *));
         void (*)(MENU *) iteminit(MENU *menu);
         int setitemterm(MENU *menu, void (*func)(MENU *));
         void (*)(MENU *) itemterm(MENU *menu);
         int setmenuinit(MENU *menu, void (*func)(MENU *));
         void (*)(MENU *) menuinit(MENU *menu);
         int setmenuterm(MENU *menu, void (*func)(MENU *));
         void (*)(MENU *) menuterm(MENU *menu);

   DESCRIPTION
         setiteminit assigns the application-defined function to be called
         when the menu is posted and just after the current item changes.
         iteminit returns a pointer to the item initialization routine, if
         any, called when the menu is posted and just after the current item
         changes.

         setitemterm assigns an application-defined function to be called
         when the menu is unposted and just before the current item changes.
         itemterm returns a pointer to the termination function, if any,
         called when the menu is unposted and just before the current item
         changes.

         setmenuinit assigns an application-defined function to be called
         when the menu is posted and just after the top row changes on a
         posted menu.  menuinit returns a pointer to the menu initialization
         routine, if any, called when the menu is posted and just after the
         top row changes on a posted menu.

         setmenuterm assigns an application-defined function to be called
         when the menu is unposted and just before the top row changes on a
         posted menu.  menuterm returns a pointer to the menu termination
         routine, if any, called when the menu is unposted and just before the
         top row changes on a posted menu.

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








   7/91                                                                 Page 1

   menu_hook(3X)                                                 menu_hook(3X)


         EOK           - The routine returned successfully.
         ESYSTEMERROR - System error.

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

   SEE ALSO
         curses(3X), menus(3X), menucontrol(3X), menuhook(3X).












































   Page 2                                                                 7/91