menuTrigger

menuTrigger( 
l_args 
) 
=> l_menuList / nil

Description

The menu trigger is called when an application is about to be installed as the current application in a window. At the time the menu trigger is called, all other triggers have already been called, and the window is about to be displayed (or if the window was a previously existing window, about to be refreshed).

The menu trigger does not install the menus itself; this is done by the Design Editor. The menu trigger merely returns a list of the menus that are to be installed when needed. The menu trigger is passed the trigger arguments in case it desires to customize its menu list according to any data in l_args. When the menu trigger for a parent view type is called due to menu inheritance, those elements of l_args derived directly from the viewType (args->viewType and args->appName) will be those derived from the parent type, not the original view type.

Arguments

l_args

List of arguments.

Values Returned

l_menuList	A list of the menus that are to be installed when needed.
nil	The execution of the function failed.

Return to top