menu_hook(3X) SDK R4.11 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:
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).
Licensed material--property of copyright holder(s)