MovieClip.gotoAndStop()

Availability

Flash Player 5.

Usage

my_mc.gotoAndStop(frame:Object) : Void

Parameters

frame The frame number to which the playhead is sent.

Returns

Nothing.

Description

Method; brings the playhead to the specified frame of the movie clip and stops it there. If you want to specify a scene in addition to a frame, use gotoAndStop().

You can extend the methods and event handlers of the MovieClip class by creating a subclass. For more information, see "Assigning a class to a movie clip symbol" in Using ActionScript in Flash.

Example

The following example uses the _framesloaded property to start a SWF file when all the frames are loaded. If all the frames aren't loaded, the _xscale property of the movie clip instance loader is increased proportionally to create a progress bar.

Enter the following ActionScript in Frame 1 of the Timeline:

var pctLoaded:Number = Math.round(this.getBytesLoaded()/this.getBytesTotal()*100);
bar_mc._xscale = pctLoaded;

Add the following code to Frame 2:

if (this._framesloaded<this._totalframes) {
   this.gotoAndPlay(1);
} else {
   this.gotoAndStop(3);
}

Place your content on or after Frame 3. Then add the following code to Frame 3:

stop();