Command Reference - Actions
Every action that could generate an error at run time has an On Error tab on its Action Properties dialog. You can use the On Error tab to configure how your AutoPlay application responds when an error is generated by that action.
User Notification
The User Notification section of the On Error tab allows you to control how much information is given to the user when an error occurs—or even whether the user is notified at all.
There are four user notification options you can choose from:
|
None |
- |
No error message is shown to the user; the user is not notified about the error at all. |
|
Simple |
- |
A simple error message is displayed on a dialog window. The error message lets the user know that something happened, but provides only basic information about the type of error that occurred. |
|
Verbose |
- |
A more specific error message is displayed. The message might include pertinent details about the error, such as the URL that a failed HTTP download action was trying to connect to. (Note: the verbose error message includes all of the text from the simple error message.) |
|
Custom: |
- |
A custom error message of your own is displayed. You can enter your own message text directly onto the On Error tab when this option is selected. |
|
TIP |
|
|
|
|
|
You can use built-in variables like %LastErrorNum%, %LastErrorMsg% and %LastErrorDetails% to incorporate the standard error message text in your custom error messages. |
Action
The Action section allows you to set the action taken by your AutoPlay application after an error occurs.
You can choose whether you want your application to close when an error occurs, or to continue performing actions. If you have any labels defined in the action list, you can even tell AutoPlay to go directly to one of the labels and continue performing actions from there.
There are three on-error action settings you can choose from:
|
Continue |
- |
After an error, the application continues with the next action in the list—i.e., the action following the one that generated the error. |
|
Continue at label |
- |
After an error, the application goes directly to the specified label and continues performing actions from there. This option is only available if there is at least one label defined in the current event's action list. |
|
Close application |
- |
After an error, the AutoPlay application closes automatically. No more actions are performed, and no more pages are shown |