
MovieClip.onUnload() Event Handler
This is the Title of the Book, eMatter Edition
Copyright © 2007 O’Reilly & Associates, Inc. All rights reserved.
Alphabetical Language Reference
|
691
MovieClip.onUnload() Event Handler
callback invoked when the clip is removed from the Stage or when unloadMovie() executes
Flash 5; callback form introduced in Flash 6
mc.onUnload()
onClipEvent (unload) {
statements
}
Description
The onUnload() event handler is the callback form (and more modern analogue) of the
legacy onClipEvent (unload) event handler. The onUnload() event is the opposite of the
onLoad() event; it occurs when
mc expires—that is, it occurs immediately after the last
frame in which
mc is present on stage (but before the first frame in which it is absent). The
onUnload() event does not apply to main movies (e.g.,
_root, _level1, etc.)
The following incidents trigger onUnload():
• The playhead reaches the end of the span of frames upon which
mc resides.
•
mc is removed via the removeMovieClip() function (which deletes clips generated by the
attachMovie() and duplicateMovieClip() functions).
• The unloadMovie() function is invoked on
mc.
•
mc has an external .swf file loaded into it.
This last onUnload() event trigger may seem a little odd, but it is actually a natural result of
the way movies are loaded into Flash. Anytime a .swf or .jpg file is loaded into a movie clip,
the previous contents of that clip are displaced, ...