menu_hook(3curses)                                menu_hook(3curses)


       NAME
             menu_hook: set_item_init, item_init, set_item_term, item_term,
             set_menu_init, menu_init, set_menu_term, menu_term - assign
             application-specific routines for automatic invocation by
             menus

       SYNOPSIS
             cc [flag . . .] file -lmenu -lcurses [library . . .]
             #include <menu.h>
             int set_item_init(MENU *menu, void (*func)(MENU *));
             void (*)(MENU *) item_init(MENU *menu);
             int set_item_term(MENU *menu, void (*func)(MENU *));
             void (*)(MENU *) item_term(MENU *menu);
             int set_menu_init(MENU *menu, void (*func)(MENU *));
             void (*)(MENU *) menu_init(MENU *menu);
             int set_menu_term(MENU *menu, void (*func)(MENU *));
             void (*)(MENU *) menu_term(MENU *menu);

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

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

             set_menu_init assigns an application-defined function to be
             called when the menu is posted and just after the top row
             changes on a posted menu.  menu_init 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.

             set_menu_term assigns an application-defined function to be
             called when the menu is unposted and just before the top row
             changes on a posted menu.  menu_term 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:


                           Copyright 1994 Novell, Inc.               Page 1

      menu_hook(3curses)                                menu_hook(3curses)


                        E_OK           - The routine returned successfully.
                        E_SYSTEM_ERROR - System error.

      NOTICES
            The header file menu.h automatically includes the header files
            eti.h and curses.h.

      REFERENCES
            curses(3curses), menus(3curses)







































                          Copyright 1994 Novell, Inc.               Page 2