Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Sets the script to be run when app becomes active.

Component Version macOS Windows Linux Server iOS SDK
iOSApp 8.2 ❌ No ❌ No ❌ No ❌ No ✅ Yes
MBS( "iOSApp.SetDidBecomeActiveScript"; Filename; ScriptName { ; Parameter } )   More


Parameter Description Example Flags
Filename The database file name where the script is located. "test.fmp12"
ScriptName The script name. "MyScript"
Parameter The script parameter. Optional


Returns OK or error.


Sets the script to be run when app becomes active.
An app is active when it is receiving events. An active app can be said to have focus. It gains focus after being launched, loses focus when an overlay window pops up or when the device is locked, and gains focus when the device is unlocked.

Version 10.2 and newer stores this in preferences, so it is restored if app when app starts again after being killed in background.


Install trigger:

Set Variable [ $r ; Value: MBS( "iOSApp.SetDidBecomeActiveScript"; Get(FileName); "Trigger"; "DidBecomeActiveScript" ) ]

See also

Release notes

Blog Entries

This function checks for a license.

Created 15th May 2018, last changed 16th March 2020

iOSApp.SetDidBecomeActiveEvaluate - iOSApp.SetDidEnterBackgroundEvaluate