
MovieClip.createEmptyMovieClip() Method
This is the Title of the Book, eMatter Edition
Copyright © 2007 O’Reilly & Associates, Inc. All rights reserved.
644
|
ActionScript Language Reference
MovieClip.createEmptyMovieClip() Method
creates a new, empty MovieClip instance
Flash 6
mc.createEmptyMovieClip(instanceName, depth)
Arguments
instanceName
A string specifying the instance name of the clip to create. The name must
adhere to the rules for creating an identifier outlined under “Identifiers” in
Chapter 15. To enable code hinting in the Flash authoring tool, use clip
instance names that include the suffix “
_mc”, as in ball_mc.
depth An integer between –16384 and 1048575 (inclusive), specifying the level on
which to place the new clip inside
mc. Higher depths obscure lower depths, so
a depth of 6 is in front of 5, which is in front of 4, and so on. Depths above –1
are reserved for dynamically generated content. Therefore, in most cases, you
should use a depth between 0 and 1048575 with createEmptyMovieClip().
However, when creating dynamic content that you want to appear beneath all
author-time content in
mc (e.g., a run-time background), use depth –16384.
Depths from –16383 to –1 (inclusive) are reserved for author-time content
and shouldn’t be used with createEmptyMovieClip(). For important details,
see “Movie and Instance Stacking Order” in Chapter 13.
Returns
A reference to the new MovieClip instance. ...