User Guide

Global Functions 63

gotoAndStop function

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

Sends the playhead to the specified frame in a scene and stops it. If no scene is specified, the

playhead is sent to the 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.

Availability: ActionScript 1.0; Flash Player 2

Parameters

scene:String [optional] - A string specifying the name of the scene to which the playhead is

sent.

frame:Object - A number representing the frame number, or a string representing the label

of the frame, to which the playhead is sent.

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(){

gotoAndStop("newFrame");

};

myOtherBtn_btn.onRelease = function(){

gotoAndStop("sceneTwo", 1);

};

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