menu_hook(3CURSES)					     Curses Library Functions						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-spe-
       cific 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 *));

       int set_item_term(MENU *menu, void (*func)(MENU *));

       void item_term(MENU *menu);

       int set_menu_init(MENU *menu, void (*func)(MENU *));

       void menu_init(MENU *menu);

       int set_menu_term(MENU *menu, void (*func)(MENU *));

       void 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 VALUES

       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.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       curses(3CURSES), menus(3CURSES), attributes(5)

NOTES

       The header <menu.h> automatically includes the headers  <eti.h> and <curses.h>.

SunOS 5.10							    31 Dec 1996 						menu_hook(3CURSES)