userMenuTrigger

userMenuTrigger( 
l_args 
) 
=> l_menuList / nil

Description

The user menu trigger is called just before the application menu trigger is called and performs the same function. This trigger allows the user to attach menus to an application. Although it is called prior to the application menu trigger, the menu list it returns is appended after the application menus.

The user menu trigger does not install the menus itself; this is done by the Design Editor. The user menu trigger merely returns a list of the menus that are to be installed when needed. The user 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 user 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