LaunchApplication

Definition:

LaunchApplication(appname, parameter[, wait])

 

Description:

Run another Digitise app, with options to pass parameters to the called app and to pause the calling app until the called app closes.

 

Platforms:

All

 

Parameters:

appname - required

String containing the name of the Digitise app to run. This is the value of the Name Property in the Project Properties for the app you want to launch.

 

parameter - required

String to be passed to the called app. You can use this parameter to pass parameters to the called app. If no parameters are required to be passed, put an empty string, "".

 

wait - optional

Determines whether the calling app should stop running until the called app has finished. It can take one of the following values:

True, "True", 1 or "1" - The calling app will pause until the called app exits.

This is the default value used if this parameter is omitted.

 

False, "False", 0 or "0" - The calling app will continue to run in background.

 

Returns:

String containing any return value from the called app or an empty string, "", if no value returned.

 

Notes:

  • The parameter parameter can contain any information you want to pass to the called app. The value must be in the form of a single string which is passed to the called app exactly as entered here.

  • Within the called app, the parameters string passed from the calling app is obtained by calling the GetStartupParameter Method.If the wait parameter is set to "False", a called app runs independently of the calling app and you can swap between the two apps as normal.

  • The wait parameter will always be set to "True" in the following situations:

    • On Android and Windows devices when the app is launched from within a Standalone App.

    • On Apple devices when the app is launched from within a Standalone App which only contains one Model designated as User.

  • To return a value from the called app, you need to include the line:

    OnExit = <value>

    in the called app's OnExit function within the OnExit Event. <value> can be either a string or an integer. You can close the called app using the ExitApplication Method.

  • You only need to allow for a return value if one will be returned.

  • When creating Standalone Apps, you must include any called apps (secondary apps) in the same Standalone App as the calling app (primary app).