overlay

Overlays the current application with the specified application.

Available in:

Apps (win)	Apps (char)	Reportwriter	RPC	Standalone PL
X	X	X	X	X

Syntax

void overlay(run-file[,parm,...])
string       run-file
expr         parm

Description

Replaces the calling application with a specified one. Returns nothing because the calling application is replaced with the new one.

run-file	specifies the application to overlay. Unless `runpath` is specified in `trim.ini`, you must give the full path name. Specifying the `.run` extention is optional.
parm	(optional) specify parameters of the overlaying function. These parameters can be accessed in the main trigger of the application.

Notes

overlay() is similar to call() and is useful in applications where the return path does not have to be preserved, such as a multi-level menu system. overlay() can also help in memory-constrained environments.

Example

Invokes an application and passes the current time as a parameter.

overlay("app1.run",g.time);