FazBrowse GitHub Viewer
|
Trending
|
URL:
|
Home
Tools:
[Download Repo ZIP]
[View Raw Code]
[Original HTTPS Page]
livecode/docs/dictionary/command/dispatch.lcdoc at develop · livecodeali/livecode · GitHub
livecodeali
/
livecode
Public
forked from
livecode/livecode
Notifications
You must be signed in to change notification settings
Fork
1
Star
0
Code
Pull requests
0
Actions
Projects
Security and quality
0
Insights
Additional navigation options
Code
Pull requests
Actions
Projects
Security and quality
Insights
Expand file tree
Breadcrumbs
livecode
/
docs
/
dictionary
/
command
/
dispatch.lcdoc
Copy path
More file actions
More file actions
Latest commit
History
History
History
90 lines (63 loc) · 2.34 KB
Breadcrumbs
livecode
/
docs
/
dictionary
/
command
/
dispatch.lcdoc
Copy path
File metadata and controls
90 lines (63 loc) · 2.34 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
Name: dispatch
Type: command
Syntax: dispatch <message> [ to <target> ][ with <argumentList> ]
Summary:
Sends a message to an object via the normal message path.
Introduced: 3.5
OS: mac, windows, linux, ios, android
Platforms: desktop, server, mobile
Example:
dispatch "updateWidget"
Example:
on mouseUp
local tWidth, tHeight
put 200 into tWidth
put 100 into tHeight
dispatch "setSize" with tWidth, tHeight
end mouseUp
on setSize pWidth, pHeight
set the width of graphic "myRectangle" to pWidth
set the height of graphic "myRectangle" to pHeight
end setSize
Example:
# An example of using an array as an argument
on mouseUp
local tDataArray
put "Mickey" into tDataArray["firstName"]
put "Mouse" into tDataArray["lastName"]
dispatch "updateUI" to card "myCard" with "Hello World", tDataArray
end mouseUp
on updateUI pTitle, @pArray
put pTitle into field "Title"
put pArray["firstName"] into field "First Name"
put pArray["lastName"] into field "Last Name"
end updateUI
Parameters:
message:
Is an expression that evaluates to the name of a handler.
target:
A reference to any LiveCode object.
argumentList:
A comma separated list of expressions containing the arguments to send.
Arrays are expressions and are valid to send as arguments.
It (enum):
Set by <dispatch> to indicate how the message was processed.
- handled: the message was handled and not passed
- unhandled: no matching handlers were found
- passed: the message was handled but passed by all handlers
Description:
Use the <dispatch> command to send a message to an object, via the
message path and find out whether it was handled or not.
The <dispatch> command is most useful when using <behavior|behaviors>,
as it allows a <behavior> script to send an 'event' to one of its child
objects and then perform an action depending on the outcome.
Executing a <dispatch> command causes the <message> to be sent to the
target object with the given argument list. This message passes through
the message path in the normal way.
If no <target> is specified, the <message> is sent to ' <me> '. In the
context of a <behavior>, this is typically the child that is executing
rather than the <behavior> object itself.
References: send (command), on (control structure), me (keyword),
it (keyword), closeControl (message), preOpenControl (message),
behavior (property)
Tags: messages
Back
|
FazBrowse Home
|
New Git URL