forked from livecode/livecode
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathdeletePlayer.lcdoc
More file actions
37 lines (23 loc) · 1.22 KB
/
Copy pathdeletePlayer.lcdoc
File metadata and controls
37 lines (23 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
33
34
35
36
37
Name: deletePlayer
Type: message
Syntax: deletePlayer
Summary: Sent to a <player> just before it is removed from the <stack>.
Associations: player
Introduced: 1.0
OS: mac,windows,linux,ios,android
Platforms: desktop,server,web,mobile
Example:
on deletePlayer -- delete the corresponding movie file
delete file (the filename of the target)
pass deletePlayer
end deletePlayer
Description:
Handle the <deletePlayer> message if you want to perform cleanup before a <player> is removed from the <stack>.
The actual deletion is not triggered by the <deletePlayer> <message>, so <trap|trapping> the <message> and not allowing it to <pass> does not prevent the <player> from being removed.
However, the undo <command> will restore a <player> after it is deleted by the user. For example, the following <handler>, placed in a <card> or stack <script>, effectively prevents a <player> from being deleted by the user:
on deletePlayer
beep
send "undo" to this card in 5 milliseconds
end deletePlayer
References: card (keyword), player (keyword), script (property), delete (command), stack (object), handler (glossary), player (glossary), message (glossary), command (glossary), trap (glossary), pass (control_st)
Tags: objects