ActionScript 3.0 Language and Components Reference All Packages | All Classes | Language Elements | Index | Appendixes | Conventions | Frames No Frames MovieClip Properties | Methods | Events | Examples InheritanceMovieClip Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object Subclasses FlexMovieClip , SystemManager , UIMovieClip , WindowedSystemManager The MovieClip class inherits from the following classes: Sprite, DisplayObjectContainer, InteractiveObject, DisplayObject, and EventDispatcher.

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

Children instances placed on the Stage in the Flash authoring tool 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.ADDED_TO_STAGE 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.

View the examples accessibilityProperties : AccessibilityProperties The current accessibility options for this display object. DisplayObject alpha : Number Indicates the alpha transparency value of the object specified. DisplayObject blendMode : String A value from the BlendMode class that specifies which blend mode to use. DisplayObject buttonMode : Boolean Specifies the button mode of this sprite. Sprite cacheAsBitmap : Boolean If set to true, Flash Player or Adobe AIR caches an internal bitmap representation of the display object. DisplayObject constructor : Object A reference to the class object or constructor function for a given object instance. Object contextMenu : NativeMenu Specifies the context menu associated with this object. InteractiveObject currentFrame : int MovieClip currentLabel : String MovieClip currentLabels : Array MovieClip currentScene : Scene MovieClip doubleClickEnabled : Boolean Specifies whether the object receives doubleClick events. InteractiveObject dropTarget : DisplayObject Sprite enabled : Boolean A Boolean value that indicates whether a movie clip is enabled. MovieClip filters : Array An indexed array that contains each filter object currently associated with the display object. DisplayObject focusRect : Object Specifies whether this object displays a focus rectangle. InteractiveObject framesLoaded : int MovieClip graphics : Graphics Sprite height : Number Indicates the height of the display object, in pixels. DisplayObject hitArea : Sprite Designates another sprite to serve as the hit area for a sprite. Sprite loaderInfo : LoaderInfo DisplayObject mask : DisplayObject The calling display object is masked by the specified mask object. DisplayObject mouseChildren : Boolean Determines whether or not the children of the object are mouse enabled. DisplayObjectContainer mouseEnabled : Boolean Specifies whether this object receives mouse messages. InteractiveObject mouseX : Number DisplayObject mouseY : Number DisplayObject name : String Indicates the instance name of the DisplayObject. DisplayObject numChildren : int DisplayObjectContainer opaqueBackground : Object Specifies whether the display object is opaque with a certain background color. DisplayObject parent : DisplayObjectContainer DisplayObject prototype : Object Object root : DisplayObject DisplayObject rotation : Number Indicates the rotation of the DisplayObject instance, in degrees, from its original orientation. DisplayObject scale9Grid : Rectangle The current scaling grid that is in effect. DisplayObject scaleX : Number Indicates the horizontal scale (percentage) of the object as applied from the registration point. DisplayObject scaleY : Number Indicates the vertical scale (percentage) of an object as applied from the registration point of the object. DisplayObject scenes : Array MovieClip scrollRect : Rectangle The scroll rectangle bounds of the display object. DisplayObject soundTransform : SoundTransform Controls sound within this sprite. Sprite stage : Stage DisplayObject tabChildren : Boolean Determines whether the children of the object are tab enabled. DisplayObjectContainer tabEnabled : Boolean Specifies whether this object is in the tab order. InteractiveObject tabIndex : int Specifies the tab ordering of objects in a SWF file. InteractiveObject textSnapshot : TextSnapshot DisplayObjectContainer totalFrames : int MovieClip trackAsMenu : Boolean Indicates whether other display objects that are SimpleButton or MovieClip objects can receive mouse release events. MovieClip transform : Transform An object with properties pertaining to a display object's matrix, color transform, and pixel bounds. DisplayObject useHandCursor : Boolean A Boolean value that indicates whether the pointing hand (hand cursor) appears when the mouse rolls over a sprite in which the buttonMode property is set to true. Sprite visible : Boolean Whether or not the display object is visible. DisplayObject width : Number Indicates the width of the display object, in pixels. DisplayObject x : Number Indicates the x coordinate of the DisplayObject instance relative to the local coordinates of the parent DisplayObjectContainer. DisplayObject y : Number Indicates the y coordinate of the DisplayObject instance relative to the local coordinates of the parent DisplayObjectContainer. DisplayObject addEventListener (type: String , listener: Function , useCapture: Boolean = false, priority: int = 0, useWeakReference: Boolean = false): void Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event. EventDispatcher Indicates whether the security restrictions would cause any display objects to be omitted from the list returned by calling the DisplayObjectContainer.getObjectsUnderPoint() method with the specified point point. DisplayObjectContainer Determines whether the specified display object is a child of the DisplayObjectContainer instance or the instance itself. DisplayObjectContainer Returns a rectangle that defines the area of the display object relative to the coordinate system of the targetCoordinateSpace object. DisplayObject Returns an array of objects that lie under the specified point and are children (or grandchildren, and so on) of this DisplayObjectContainer instance. DisplayObjectContainer Returns a rectangle that defines the boundary of the display object, based on the coordinate system defined by the targetCoordinateSpace parameter, excluding any strokes on shapes. DisplayObject Converts the point object from the Stage (global) coordinates to the display object's (local) coordinates. DisplayObject Checks whether the EventDispatcher object has any listeners registered for a specific type of event. EventDispatcher Evaluates the display object to see if it overlaps or intersects with the obj display object. DisplayObject Evaluates the display object to see if it overlaps or intersects with the point specified by the x and y parameters. DisplayObject Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter. Object Converts the point object from the display object's (local) coordinates to the Stage (global) coordinates. DisplayObject Removes the specified child DisplayObject instance from the child list of the DisplayObjectContainer instance. DisplayObjectContainer Removes a child DisplayObject from the specified index position in the child list of the DisplayObjectContainer. DisplayObjectContainer removeEventListener (type: String , listener: Function , useCapture: Boolean = false): void Removes a listener from the EventDispatcher object. EventDispatcher Swaps the z-order (front-to-back order) of the child objects at the two specified index positions in the child list. DisplayObjectContainer Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type. EventDispatcher currentFrame: int [read-only]

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. Implementation public function get currentFrame(): int Example

currentLabel: String [read-only]

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 . Implementation public function get currentLabel(): String Example

currentLabels: Array [read-only]

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. Implementation public function get currentLabels(): Array See also flash.display.FrameLabel Example

enabled: Boolean [read-write]

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.

Implementation public function get enabled(): Boolean public function set enabled(value: Boolean ): void Example framesLoaded: int [read-only]

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.

Implementation public function get framesLoaded(): int See also Loader class Example MovieClip()Constructor public function MovieClip() Creates a new MovieClip instance. After creating the MovieClip, call the addChild() or addChildAt() method of a display object container that is onstage. gotoAndPlay()method public function gotoAndPlay(frame: Object , scene: String = null): 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. Parameters frame : Object — 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. public function gotoAndStop(frame: Object , scene: String = null): 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. Parameters frame : Object — 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. public 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. See also prevFrame() Example