User Guide

gotoAndPlay() 323

gotoAndPlay()

Availability

Flash 2.

Usage

gotoAndPlay([scene:String,] frame:Object) : Void

Parameters

scene

An optional string specifying the name of the scene to which the playhead is sent.

frame A number representing the frame number, or a string representing the label of the frame,

to which the playhead is sent.

Returns

Nothing.

Description

Function; sends the playhead to the specified frame in a scene and plays from that frame. If no

scene is specified, the playhead goes to the specified frame in the current scene.

You can use the

scene parameter only on the root Timeline, not within Timelines for movie clips

or other objects in the document.

Example

In the following example, a document has two scenes: sceneOne and sceneTwo. Scene one

contains a frame label on Frame 10 called

newFrame and two buttons, myBtn_btn and

myOtherBtn_btn. This ActionScript is placed on Frame 1, Scene 1 of the main Timeline.

stop();

myBtn_btn.onRelease = function(){

gotoAndPlay("newFrame");

};

myOtherBtn_btn.onRelease = function(){

gotoAndPlay("sceneTwo", 1);

};

When the user clicks the buttons, the playhead moves to the specified location and continues

playing.