Manual pages › X Window and screen libraries (3X)

menu_hook(3X)

assign application-specific routines for automatic invocation by menus

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

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