Call Program (Magic xpa 4.x)
You can use the Program ID to invoke subroutines, which are used throughout the project, for implementing:
The Program properties are:
Program ID
Arguments
Result
Form
Destination
Retain focus
Lock
Sync Data
Condition (Cnd)
The following properties are available only in Route event:
Route name
Route parameters
Since version: 4.0
The Call Program operation is often used to implement zoomable windows.
A program can be invoked in three ways:
A program can call itself and even pass arguments to itself. Magic xpa programs are fully recursive up to the maximum execution nesting depth.
If a maximized program calls a program, the called program will also be opened as maximized.
To allow Magic xpa to automatically update the program number inside the expression when the sequential number of the referred program changes in the Program repository, use the PROG literal in the expression. For example, suppose you want to execute either program number 3 or program number 4, depending on the value of the logical variable BA. The Exp you define should be (IF BA,'3'PROG,'4'PROG).
In Rich Client, the called program will return a value only if it is a batch program. This is because the Call Program operation will be executed on the server, and it will not wait until a Rich Client program, which is executed on the client side, will be terminated.
|
|
When working with a Call Program operation, you can easily jump to the program by pressing Ctrl+F5 or opening the Options menu and selecting Go to Object. Once you are done, you can return to the Call Program operation by pressing Ctrl+Shift+F5 or selecting Options > Return to Object.
However, if the program is from the CRR, the Go to Object functionality will not work. To make this work, add the component application as a module.
See also How Do I Drill Down into a Called Program?
|
Call Operations
Call Properties
