forked from livecode/livecode
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathcall.lcdoc
More file actions
36 lines (21 loc) · 2.2 KB
/
Copy pathcall.lcdoc
File metadata and controls
36 lines (21 loc) · 2.2 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
Name: call
Type: command
Syntax: call <handler> [of <object>]
Summary: <execute|Executes> the specified <handler> in any <object'sscript>.
Introduced: 1.0
OS: mac,windows,linux,ios,android
Platforms: desktop,server,web
Example:
call "mouseUp"
Example:
call "mouseUp" of button 1 of card 1
Parameters:
handler: Any handler in the script of the specified object, along with any parameters that handler requires, separated by commas. The entire handler including parameters must be enclosed in quotes.
object: Any object reference. If no object is specified, LiveCode uses the current object.
Description:
Use the <call> <command> to use a <handler> that's not in the normal <message path>.
The <call> <command> sends a <handler> <message> to the <object>. If the <script> of the <object> doesn't <trap> the <handler> <message>, the <message> is <pass|passed> to the next <object> in the object's <message path>.
When executing a handler invoked by the call command the <defaultStack> remains the same as it was when the call command was issued. Therefore any object references in the called handler are evaluated in the context of the call command that invoked the handler. For example, button 3 may commonly refer to button 3 of the current card of the stack from which the target handler was called.
This differs from the <send> <command> which temporarily changes the context so that object references are evaluated in the context of the object containing the target handler.
>*Tip:* If a <handler> contains complex <parameter|parameters>, especially if some <parameter|parameters> contain <double quote|double quotes>, it may be simpler to put the <message> name and <parameter|parameters> into a <variable>, then use the name of the <variable> in the <call> <statement>.
References: script (property), defaultStack (property), object'sscript (object), object (object), do (command), send (command), insert script (command), start using (command), value (function), params (function), pass (control_st), trap (glossary), variable (glossary), handler (glossary), execute (glossary), pass (glossary), message path (glossary), message (glossary), statement (glossary), double quote (glossary), command (glossary), parameter (glossary)