exit to top | |
Type | control structure |
Dictionary | LCS |
Library | LiveCode Script |
Syntax |
|
Synonyms | exit to metacard,exit to supercard,exit to hypercard |
Summary | |
Introduced | 1.0 |
OS | mac, windows, linux, ios, android |
Platforms | desktop, server, mobile |
Example |
|
Related | Keyword: card, top Message: closeCard, openCard Command: call Glossary: function handler, message handler, pass, setProp handler, execute, function call, control structure, getProp handler, trigger, getProp call, message path, message, statement, handler, object Control Structure: pass, exit, if |
Description | Use the exit to top control structure to stop executing the current handler and suppress pending 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 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 controlstructure is executed in a closeCard handler, the corresponding openCard message is not sent to the destination card.
|