When a user runs an application, an Open event is triggered in the Application object. The script you write for the Open event initiates the activity in the application. Typically it sets up the environment and opens the initial window.
When a user ends an application, a Close event is triggered in the Application object. The script you write for the Close event usually does all the cleanup required, such as closing a database or writing a preferences file.
If there are serious errors during execution, a SystemError event is triggered in the Application object.
Batch applications If your application performs only batch processing, all processing takes place in the script for the application Open event.
Table 3-8 lists all events that can occur in the Application object. The only event that requires a script is Open.
Event |
Occurs when |
---|---|
Open |
The user starts the application. |
Close |
The user closes the application. Typically, you write a script for this event that shuts everything down (such as closing the database connection and writing out a preferences file). |
SystemError |
A serious error occurs during execution (such as trying to open a nonexistent window). If there is no script for this event, PocketBuilder displays a message box with the PocketBuilder error number and message text. If there is a script, PocketBuilder executes the script. For more about error handling, see “Handling errors during execution”. |
Idle |
The Idle PowerScript function has been called and the specified number of seconds has elapsed with no mouse or keyboard activity. |