522
Chapter 2: ActionScript Language Reference
MovieClip.getInstanceAtDepth()
Availability
Flash Player 7.
Usage
my_mc
.getInstanceAtDepth(
depth:Number
)
: MovieClip
Parameters
depth
An integer that specifies the depth level to query.
Returns
A reference to the MovieClip instance located at the specified depth, or
undefined
if there is no
movie clip at that depth.
Description
Method; lets you determine if a particular depth is already occupied by a movie clip. You can use
this method before using
MovieClip.attachMovie()
,
MovieClip.duplicateMovieClip()
, or
MovieClip.createEmptyMovieClip()
to determine if the depth parameter you want to pass to
any of these methods already contains a movie clip. For more information, see “Managing movie
clip depths” in
Using ActionScript in Flash
.
You can extend the methods and event handlers of the MovieClip class by creating a subclass. For
more information, see “Assigning a class to a movie clip symbol” in
Using ActionScript in Flash
.
Example
The following example displays the depth occupied by the
logo_mc
movie clip instance in the
Output panel:
this.createEmptyMovieClip("logo_mc", 1);
logo_mc.loadMovie("http://www.macromedia.com/devnet/mx/blueprint/articles/
nielsen/spotlight_jnielsen.jpg");
trace(this.getInstanceAtDepth(1)); // output: _level0.logo_mc
See also
MovieClip.getDepth()
,
MovieClip.getNextHighestDepth()
,
MovieClip.swapDepths()
Summary of Contents for FLASH MX 2004-ACTIONSCRIPT LANGUAGE
Page 1: ...ActionScript Language Reference...
Page 20: ...20 Contents...
Page 24: ...24 Chapter 1 Introduction...
Page 145: ...Button onKeyDown 145 See also Button onKeyUp...
Page 186: ...186 Chapter 2 ActionScript Language Reference See also Camera onActivity Camera setMotionLevel...
Page 202: ...202 Chapter 2 ActionScript Language Reference See also break default strict equality switch...
Page 282: ...282 Chapter 2 ActionScript Language Reference See also break continue while...
Page 383: ...LoadVars addRequestHeader 383 See also XML addRequestHeader...
Page 388: ...388 Chapter 2 my_lv load place a valid URL pointing to a text file here...
Page 463: ...Microphone setRate 463 See also Microphone rate...
Page 469: ...Microphone silenceLevel 469 See also Microphone gain Microphone setSilenceLevel...
Page 480: ...480 Chapter 2 ActionScript Language Reference See also Mouse addListener...
Page 529: ...MovieClip globalToLocal 529 See also MovieClip getBounds MovieClip localToGlobal...
Page 612: ...612 Chapter 2 ActionScript Language Reference See also MovieClipLoader onLoadStart...
Page 623: ...NetConnection class 623 See also NetStream class Video attachVideo...
Page 649: ...Number 649 See also NaN Number class...
Page 679: ...on 679 on release trace X this _x trace Y this _y stopDrag See also onClipEvent...
Page 683: ...onUpdate 683 buttonLabel textColor my_mc labelColor...
Page 788: ...788 Chapter 2 ActionScript Language Reference See also private public...
Page 1001: ...Video height 1001 my_mc _height my_mc my_video height See also MovieClip _height Video width...
Page 1022: ...1022 Chapter 2 ActionScript Language Reference See also XML createElement...
Page 1057: ...XML xmlDecl 1057 See also XML docTypeDecl XML toString...
Page 1070: ...1070 Chapter 2 ActionScript Language Reference...