b = execpff(pff_filename ‖ pff_name『, flags』);
function starts another CSPro application. This function is useful when designing menu programs or when conducting surveys that use multiple machines on which the path of the CSPro executables may differ. The function is very similar to execsystem
, but instead of passing the name of an application or task, you supply a string expression, pff_filename
, containing the name of a CSPro application's Program Information File (.pff)
, or pff_name
, the name of a pff
object. If using a modified but unsaved pff object, it will be saved to a temporary file and then executed.
An optional set of flags
, described in the execsystem
helps, allow you to control how the CSPro application is opened.
On mobile devices, multiple data entry applications cannot be run simultaneously, so the function simply stores the file name of the PFF. When the mobile application returns to the Entry Applications screen, whether via user interaction or via the stop
function, the passed PFF will be launched. Using stop
as a flag will cause the PFF to be launched immediately.
If the PFF file that launched the application that calls this function specified an OnExit parameter, the pff_filename specified by this function will override the OnExit parameter.
The function returns a logical value of 1 (true) if the new application is started successfully and 0 (false) otherwise.