menu_hook(3X)                    DG/UX 5.4.2                   menu_hook(3X)


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
       #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:
       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>.

SEE ALSO
       curses(3X), menus(3X), menu_control(3X), menu_hook(3X).



Licensed material--property of copyright holder(s)                         1