menu_hook(3X) MISCELLANEOUS LIBRARY FUNCTIONS 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 ini-
tialization 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 termina-
tion 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.
Last change: 1
menu_hook(3X) MISCELLANEOUS 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), menu_control(3X), menu_hook(3X).
Last change: 2