menu_hook(3X) LIBRARY FUNCTIONS 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 ini-
tialization 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 termina-
tion 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.
1
menu_hook(3X) LIBRARY FUNCTIONS menu_hook(3X)
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).
2