MACROMEDIA DIRECTOR MX 2004, Reference

Page: 172 / 1130

172 Chapter 10: Events and Messages
on exitFrame
Usage
-- Lingo syntax
on exitFrame
statement ( s )
end
// JavaScript syntax
function exitFrame() {
statement ( s );
}
Description
System message and event handler; contains statements that run each time the playhead exits the
frame that the
on exitFrame
handler is attached to. The
on exitFrame
handler is a useful place
for Lingo that resets conditions that are no longer appropriate after leaving the frame.
Place
on exitFrame
handlers in behavior, frame, or movie scripts, as follows:
•
To assign the handler to an individual sprite, put the handler in a behavior attached to
the sprite.
•
To assign the handler to an individual frame, put the handler in the frame script.
•
To assign the handler to every frame unless explicitly instructed otherwise, put the handler in a
movie script. The
on exitFrame
handler then executes every time the playhead exits the frame
unless the frame script has its own
on exitFrame
handler. When the frame script has its own
on exitFrame
handler, the
on exitFrame
handler in the frame script overrides the one in the
movie script.
This event is passed the sprite script or frame script reference
me
if it is used in a behavior. The
order of frame events is
prepareFrame
,
enterFrame
, and
exitFrame
.
Example
This handler turns off all puppet conditions when the playhead exits the frame:
-- Lingo syntax
on exitFrame me
repeat with i = 48 down to 1
sprite(i).scripted = FALSE
end repeat
end
// JavaScript syntax
function exitFrame() {
for (i=48; i>=1; i--);
sprite(i).scripted = false;
}
}