forked from livecode/livecode
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy patherrorDialog.lcdoc
More file actions
45 lines (27 loc) · 2.41 KB
/
Copy patherrorDialog.lcdoc
File metadata and controls
45 lines (27 loc) · 2.41 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
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)