class flash.display.MovieClip extends Sprite

Available on all platforms

The MovieClip class inherits from the following classes: Sprite, * DisplayObjectContainer, InteractiveObject, DisplayObject, and * EventDispatcher. *

Unlike the Sprite object, a MovieClip object has a timeline.

*

>In Flash Professional, the methods for the MovieClip class provide the * same functionality as actions that target movie clips. Some additional * methods do not have equivalent actions in the Actions toolbox in the * Actions panel in the Flash authoring tool.

*

Children instances placed on the Stage in Flash Professional cannot be * accessed by code from within the constructor of a parent instance since * they have not been created at that point in code execution. Before * accessing the child, the parent must instead either create the child * instance by code or delay access to a callback function that listens for * the child to dispatch its Event.ADDEDTOSTAGE event.

*

If you modify any of the following properties of a MovieClip object that * contains a motion tween, the playhead is stopped in that MovieClip object: * alpha, blendMode, filters, * height, opaqueBackground, rotation, * scaleX, scaleY, scale9Grid, * scrollRect, transform, visible, * width, x, or y. However, it does not * stop the playhead in any child MovieClip objects of that MovieClip * object.

* *

Note:Flash Lite 4 supports the MovieClip.opaqueBackground * property only if FEATUREBITMAPCACHE is defined. The default configuration * of Flash Lite 4 does not define FEATUREBITMAPCACHE. To enable the * MovieClip.opaqueBackground property for a suitable device, define * FEATURE_BITMAPCACHE in your project.

Instance Fields

var currentFrame:Int

Specifies the number of the frame in which the playhead is located in the * timeline of the MovieClip instance. If the movie clip has multiple scenes, * this value is the frame number in the current scene.

var currentFrameLabel:String

The label at the current frame in the timeline of the MovieClip instance. * If the current frame has no label, currentLabel is * null.

var currentLabel:String

The current label in which the playhead is located in the timeline of the * MovieClip instance. If the current frame has no label, * currentLabel is set to the name of the previous frame that * includes a label. If the current frame and previous frames do not include * a label, currentLabel returns null.

var currentLabels:Array<FrameLabel>

Returns an array of FrameLabel objects from the current scene. If the * MovieClip instance does not use scenes, the array includes all frame * labels from the entire MovieClip instance.

var currentScene:Scene

The current scene in which the playhead is located in the timeline of the * MovieClip instance.

var enabled:Bool

A Boolean value that indicates whether a movie clip is enabled. The * default value of enabled is true. If * enabled is set to false, the movie clip's Over, * Down, and Up frames are disabled. The movie clip continues to receive * events(for example, mouseDown, mouseUp, * keyDown, and keyUp). * *

The enabled property governs only the button-like * properties of a movie clip. You can change the enabled * property at any time; the modified movie clip is immediately enabled or * disabled. If enabled is set to false, the object * is not included in automatic tab ordering.

var framesLoaded:Int

The number of frames that are loaded from a streaming SWF file. You can * use the framesLoaded property to determine whether the * contents of a specific frame and all the frames before it loaded and are * available locally in the browser. You can also use it to monitor the * downloading of large SWF files. For example, you might want to display a * message to users indicating that the SWF file is loading until a specified * frame in the SWF file finishes loading. * *

If the movie clip contains multiple scenes, the * framesLoaded property returns the number of frames loaded for * all scenes in the movie clip.

var scenes:Array<Scene>

An array of Scene objects, each listing the name, the number of frames, * and the frame labels for a scene in the MovieClip instance.

var totalFrames:Int

The total number of frames in the MovieClip instance. * *

If the movie clip contains multiple frames, the * totalFrames property returns the total number of frames in * all scenes in the movie clip.

var trackAsMenu:Bool

Indicates whether other display objects that are SimpleButton or MovieClip * objects can receive mouse release events or other user input release * events. The trackAsMenu property lets you create menus. You * can set the trackAsMenu property on any SimpleButton or * MovieClip object. The default value of the trackAsMenu * property is false. * *

You can change the trackAsMenu property at any time; the * modified movie clip immediately uses the new behavior.

function new():Void

Creates a new MovieClip instance. After creating the MovieClip, call the * addChild() or addChildAt() method of a display * object container that is onstage.

function addFrameScript(?p1:Dynamic, ?p2:Dynamic, ?p3:Dynamic, ?p4:Dynamic, ?p5:Dynamic):Void

function gotoAndPlay(frame:Object, ?scene:String):Void

Starts playing the SWF file at the specified frame. This happens after all * remaining actions in the frame have finished executing. To specify a scene * as well as a frame, specify a value for the scene parameter. * *

frame

A number representing the frame number, or a string representing the label of the frame, to which the playhead is sent. If you specify a number, it is relative to the scene you specify. If you do not specify a scene, the current scene determines the global frame number to play. If you do specify a scene, the playhead jumps to the frame number in the specified scene. *

scene

The name of the scene to play. This parameter is optional.

function gotoAndStop(frame:Object, ?scene:String):Void

Brings the playhead to the specified frame of the movie clip and stops it * there. This happens after all remaining actions in the frame have finished * executing. If you want to specify a scene in addition to a frame, specify * a scene parameter. * *

frame

A number representing the frame number, or a string representing the label of the frame, to which the playhead is sent. If you specify a number, it is relative to the scene you specify. If you do not specify a scene, the current scene determines the global frame number at which to go to and stop. If you do specify a scene, the playhead goes to the frame number in the specified scene and stops. *

scene

The name of the scene. This parameter is optional. *

function nextFrame():Void

Sends the playhead to the next frame and stops it. This happens after all * remaining actions in the frame have finished executing.

function nextScene():Void

Moves the playhead to the next scene of the MovieClip instance. This * happens after all remaining actions in the frame have finished executing.

function play():Void

Moves the playhead in the timeline of the movie clip.

function prevFrame():Void

Sends the playhead to the previous frame and stops it. This happens after * all remaining actions in the frame have finished executing.

function prevScene():Void

Moves the playhead to the previous scene of the MovieClip instance. This * happens after all remaining actions in the frame have finished executing.

function stop():Void

Stops the playhead in the movie clip.