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);