menu_hook(3X)                    UNIX System V                    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:
      E_OK           - The routine returned successfully.
      E_SYSTEM_ERROR - System error.

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





10/89                                                                    Page 1

menu_hook(3X)                    UNIX System V                    menu_hook(3X)


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




















































Page 2                                                                    10/89