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.
When calling the execpff
function from a desktop CSPro application on a computer where the Universal Windows CSEntry mobile application has been installed, it is possible to launch a PFF in the Universal Windows application by using mobile
as a flag. The application being launched must have already been added as an application to the Universal Windows application. When using the mobile
flag, specify only the name of the PFF file in pff_filename
) and not the full path to the file. When using the mobile
flag, all flags other than stop
The function returns a logical value of 1 (true) if the new application is started successfully and 0 (false) otherwise.