Name: errorDialog

Type: message

Syntax: errorDialog <executionError>, <parseError> 

Summary: Sent to an <object> when one of its <handler|handlers> cannot be run due to an <execution error>.

Associations: stack,card,field,button,graphic,scrollbar,player,image

Introduced: 1.0

OS: mac,windows,linux

Platforms: desktop,server,web

Example:
on errorDialog pExecutionError, pParseError
    answer "An error occurred on line: " & item 2 of line 1 of pExecutionError
end errorDialog

Parameters:
executionError: The errorDialog message is sent with two parameters.
 The executionError describes the error that occurred.
parseError: Deprecated.The executionError parameter is a standard LiveCode error backtrace in the form: <error-code>,<line-number>,<column-number>[, <hint>]

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 cErrorsList of card 1 of stack "revErrorDisplay"

>*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.

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

References: executionContexts (property), lockErrorDialogs (property), script (property), scriptParsingError (message), lock error dialogs (command), unlock error dialogs (command), interrupt (function), format (function), errorObject (function), object (object), property (glossary), handle (glossary), handler (glossary), error (glossary), message (glossary), execution error (glossary), command (glossary)
