errorDialog

Typemessage
DictionaryLCS
LibraryLiveCode Script
Syntax
errorDialog <pExecutionError>, <pParseError>
Associationsstack
Summary

Sent to an object when one of its handlers cannot be run due to an execution error.

Introduced1.0
Changes

The pExecutionError parameter was introduced in version 1.1. In previous versions, this information was stored in the executionError property.

OSmac, windows, linux
Platformsdesktop, server
Parameters
NameTypeDescription
pExecutionError

Describes the error that occurred in the form of a standard LiveCode error backtrace: error-code,line-number,column-number[, hint]

pParseError

Deprecated

Example
on errorDialog pExecutionError, pParseError
    answer "An error occurred on line: " & item 2 \
          of line 1 of pExecutionError
end errorDialog
RelatedProperty: executionContexts, lockErrorDialogs, script
Message: scriptParsingError
Command: lock error dialogs, unlock error dialogs
Function: interrupt, format, errorObject
Glossary: object, property, handle, handler, error, message, execution error, command
Description

Handle the errorDialog message to prevent the standard error window from appearing, when you want to handle the error in a custom handler.

Standard error descriptions are stored in the cErrorsList of the first card of stack "revErrorDisplay". The error-code refers to the line number in this custom property which contains the error description.

You can look up the description of an error using this line of code:

answer line (item 1 of line 1 of pExecutionError) of the scriptExecutionErrors

Note: The exact format of the executionError may change from release to release.

If the lockErrorDialogs property is true, the errorDialog message is sent to the object that set the lockErrorDialogs, rather than to the object whose script contained the error. The lockErrorDialogs can be set to true either by setting the property directly, or with the lock error dialogs command.

Note: The errorDialog message is only sent while Script Debug mode is turned off. To toggle Script Debug mode, click on the Development menu of LiveCode's menubar.