forked from livecode/livecode
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathcloseStackRequest.lcdoc
More file actions
32 lines (19 loc) · 1.22 KB
/
Copy pathcloseStackRequest.lcdoc
File metadata and controls
32 lines (19 loc) · 1.22 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
Name: closeStackRequest
Type: message
Syntax: closeStackRequest
Summary: Sent to the <current card> when the user tries to close a <stack>.
Associations: card
Introduced: 1.0
OS: mac,windows,linux,ios,android
Platforms: desktop,server,web,mobile
Example:
on closeStackRequest
answer "Are you sure?" with "No" or "Yes"
if it is "Yes" then pass closeStackRequest
end closeStackRequest
Description:
Handle the <closeStackRequest> <message> if you want to prevent a <stack> from being closed.
If the <closeStackRequest> <handler> does not <pass> the <message> or send it to a further <object(glossary)> in the <message path>, the <stack> does not close. <pass|Passing> the <message> allows the <stack> to close.
The <closeStackRequest> message is only sent if the request to close a stack is initiated by the user (eg by clicking file -> close in the LiveCode menu). If the request is initiated from a script (eg "close this stack") then the <closeStackRequest> message is not sent.
References: decorations (property), closeStack (message), close (command), stack (object), object (glossary), handler (glossary), current card (glossary), pass (glossary), message (glossary), message path (glossary), pass (control structure)
Tags: ui