Flash CS3 Documentation

ActionScript 2.0 Language Reference > ActionScript language elements > Global Functions > gotoAndStop function

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.

See also

gotoAndStop (MovieClip.gotoAndStop method), stop function, play function, gotoAndPlay function

Flash CS3