This repository was archived by the owner on Aug 31, 2021. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 225
Expand file tree
/
Copy pathexit-to-top.lcdoc
More file actions
58 lines (42 loc) · 2.16 KB
/
exit-to-top.lcdoc
File metadata and controls
58 lines (42 loc) · 2.16 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
46
47
48
49
50
51
52
53
54
55
56
57
Name: exit to top
Synonyms: exit to metacard, exit to supercard, exit to hypercard
Type: control structure
Syntax: exit to top
Summary:
Halts the current <handler> and all pending <handler|handlers>.
Introduced: 1.0
OS: mac, windows, linux, ios, android
Platforms: desktop, server, mobile
Example:
if the result is not empty then exit to top -- stop everything
Description:
Use the <exit to top> <control structure> to stop <execute|executing>
the current <handler> and suppress pending <message|messages>.
**Form:** The <exit to top> <statement> appears on a line by itself,
anywhere inside a <handler>.
Usually, <exit to top> is used within an <if> <control structure>, so
that <execute|execution> stops if a condition is true and continues if
the condition is false.
You can use an <exit to top> <statement> in a <message handler>,
<function handler>, <getProp handler>, or <setProp handler>.
If the current handler was called from another handler, the calling
handler is also halted. Other messages that depend on the same action
are also suppressed: for example, if an <exit to top> <control
structure> is executed in a <closeCard> <handler>, the corresponding
<openCard> <message> is not sent to the destination <card>.
>*Important:* When a <handler> <execute|executes> an <exit to top>
> <statement>, the <message>, setProp <trigger>, <function call>, or
> <getProp call> is not <pass|passed> to the next <object(glossary)> in
> the <message path>. To halt the current <handler> and <pass> the
> <message>, <trigger>, or <call> to the next <object(glossary)> in the
> <message path>, use the <pass> <control structure> instead of <exit>
> or <exit to top>.
References: call (command), pass (control structure),
exit (control structure), if (control structure),
function handler (glossary), message handler (glossary), pass (glossary),
setProp handler (glossary), execute (glossary), function call (glossary),
control structure (glossary), getProp handler (glossary),
trigger (glossary), getProp call (glossary), message path (glossary),
message (glossary), statement (glossary), handler (glossary),
object (glossary), card (keyword), top (keyword), closeCard (message),
openCard (message)