currentLabels: Array [read-only]

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Related API Elements

Example  ( How to use this example )

The following code illustrates how to use the currentLabels property of a MovieClip object named mc1 : import flash.display.FrameLabel; var labels:Array = mc1.currentLabels; for (var i:uint = 0; i < labels.length; i++) { var label:FrameLabel = labels[i]; trace("frame " + label.frame + ": " + label.name);

currentScene: Scene [read-only]

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Implementation
public function get currentScene(): Scene

Related API Elements

Example  ( How to use this example )

The following code illustrates how to use the currentScene property of a MovieClip object named mc1 : import flash.display.Scene; var scene:Scene = mc1.currentScene; trace(scene.name + ": " + scene.numFrames + " frames");

enabled: Boolean

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

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  ( How to use this example )

The following code illustrates how to use the enabled property to disable the button-like properties of a MovieClip object named mc1 : mc1.enabled = false;

framesLoaded: int [read-only]

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Related API Elements

Example  ( How to use this example )

The following code illustrates how to use the framesLoaded property and the totalFrames property to determine if a streaming MovieClip object named mc1 is fully loaded: if (mc1.framesLoaded == mc1.totalFrames) { trace("OK.");

isPlaying: Boolean [read-only]

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 3.0, Flash Player 11

A Boolean value that indicates whether a movie clip is curently playing.

Implementation
public function get isPlaying(): Boolean

scenes: Array [read-only]

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Implementation
public function get scenes(): Array

Related API Elements

Example  ( How to use this example )

The following code illustrates how to use the scenes property of a MovieClip object named mc1 : import flash.display.Scene; for (var i:uint = 0; i < mc1.scenes.length; i++) { var scene:Scene = mc1.scenes[i]; trace("scene " + scene.name + ": " + scene.numFrames + " frames");

totalFrames: int [read-only]

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

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.

Implementation
public function get totalFrames(): int

Example  ( How to use this example )

The following code illustrates the use of the totalFrames property of a MovieClip object named mc1 : trace(mc1.totalFrames);

trackAsMenu: Boolean

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9

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.

Implementation
public function get trackAsMenu(): Boolean
public function set trackAsMenu(value: Boolean ): void

Example  ( How to use this example )

The following code illustrates how to use the trackAsMenu property to enable mouse release events for a MovieClip object named mc1 : mc1.trackAsMenu = true;

public function MovieClip()

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

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

public function gotoAndPlay(frame: Object , scene: String = null): void

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

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.
	scene : String (default = null ) — The name of the scene to play. This parameter is optional.

Example  ( How to use this example )

The following code uses the gotoAndPlay() method to direct the playhead of the mc1 movie clip to advance five frames ahead of its current location: mc1.gotoAndPlay(mc1.currentFrame + 5);

The following code uses the gotoAndPlay() method to direct the playhead of the mc1 movie clip to the frame labeled "intro" in the scene named "Scene 12" : mc1.gotoAndPlay("intro", "Scene 12");

public function gotoAndStop(frame: Object , scene: String = null): void

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

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.
	scene : String (default = null ) — The name of the scene. This parameter is optional.

Throws

ArgumentError — If the scene or frame specified are not found in this movie clip.

Example  ( How to use this example )

The following code uses the gotoAndStop() method and the currentFrame property to direct the playhead of the mc1 movie clip to advance five frames ahead of its current location and stop: mc1.gotoAndStop(mc1.currentFrame + 5);

The following code uses the gotoAndStop() to direct the playhead of the mc1 movie clip to the frame labeled "finale" in the scene named "Scene 12" and stop the playhead: mc1.gotoAndStop("finale", "Scene 12");

public function nextFrame(): void

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Related API Elements

Example  ( How to use this example )

In the following example, two SimpleButton objects control the timeline. The prev button moves the playhead to the previous frame, and the nextBtn button moves the playhead to the next frame: import flash.events.MouseEvent; mc1.stop(); prevBtn.addEventListener(MouseEvent.CLICK, goBack); nextBtn.addEventListener(MouseEvent.CLICK, goForward); function goBack(event:MouseEvent):void { mc1.prevFrame(); function goForward(event:MouseEvent):void { mc1.nextFrame();

public function nextScene(): void

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Example  ( How to use this example )

In the following example, two SimpleButton objects control the timeline. The prevBtn button moves the playhead to the previous scene, and the nextBtn button moves the playhead to the next scene: import flash.events.MouseEvent; mc1.stop(); prevBtn.addEventListener(MouseEvent.CLICK, goBack); nextBtn.addEventListener(MouseEvent.CLICK, goForward); function goBack(event:MouseEvent):void { mc1.prevScene(); function goForward(event:MouseEvent):void { mc1.nextScene();

public function play(): void

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

Moves the playhead in the timeline of the movie clip.

Related API Elements

Example  ( How to use this example )

The following code uses the stop() method to stop a movie clip named mc1 and to resume playing when the user clicks the text field named continueText : import flash.text.TextField; import flash.events.MouseEvent; var continueText:TextField = new TextField(); continueText.text = "Play movie..."; addChild(continueText); mc1.stop(); continueText.addEventListener(MouseEvent.CLICK, resumeMovie); function resumeMovie(event:MouseEvent):void { mc1.play();

public function prevFrame(): void

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Example  ( How to use this example )

In the following example, two SimpleButton objects control the timeline. The prev button moves the playhead to the previous frame, and the nextBtn button moves the playhead to the next frame: import flash.events.MouseEvent; mc1.stop(); prevBtn.addEventListener(MouseEvent.CLICK, goBack); nextBtn.addEventListener(MouseEvent.CLICK, goForward); function goBack(event:MouseEvent):void { mc1.prevFrame(); function goForward(event:MouseEvent):void { mc1.nextFrame();

public function prevScene(): void

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Example  ( How to use this example )

In the following example, two SimpleButton objects control the timeline. The prevBtn button moves the playhead to the previous scene, and the nextBtn button moves the playhead to the next scene: import flash.events.MouseEvent; mc1.stop(); prevBtn.addEventListener(MouseEvent.CLICK, goBack); nextBtn.addEventListener(MouseEvent.CLICK, goForward); function goBack(event:MouseEvent):void { mc1.prevScene(); function goForward(event:MouseEvent):void { mc1.nextScene();

public function stop(): void

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

Stops the playhead in the movie clip.

The following example uses the MovieClipExample class to illustrate how to monitor various properties of a MovieClip. This task is accomplished by performing the following steps:

1. The constructor function defines a text field, which is used to display values of properties of the MovieClipExample object (which extends MovieClip).
2. The return value of the getPropertiesString() method is used as text for the outputText text field. The getPropertiesString() method returns a string that is populated with values of the following properties of the movie clip: currentFrame , currentLabel , currentScene , framesLoaded , totalFrames , and trackAsMenu .
3. Two lines of code in the constructor function adjust the width and height properties of the outputText text field.
4. The last line of the constructor function adds the outputText text field to the display list.

package { import flash.display.MovieClip; import flash.text.TextField; public class MovieClipExample extends MovieClip { public function MovieClipExample() { var outputText:TextField = new TextField(); outputText.text = getPropertiesString(); outputText.width = stage.stageWidth; outputText.height = outputText.textHeight; addChild(outputText); private function getPropertiesString():String { var str:String = "" + "currentFrame: " + currentFrame + "\n" + "currentLabel: " + currentLabel + "\n" + "currentScene: " + currentScene + "\n" + "framesLoaded: " + framesLoaded + "\n" + "totalFrames: " + totalFrames + "\n" + "trackAsMenu: " + trackAsMenu + "\n"; return str;