U-X > unloadMovie

 

unloadMovie

unloadmovie, unload

Availability

Flash Player 3.

Usage

unloadMovie[Num](level/"target")

Parameters

level The level (_levelN) of a loaded movie.

When the Actions panel is in normal mode, you can specify either a target parameter or a level parameterof a target movie; you can't specify both parameters.If you select a level parameter of a target movie while in normal mode, Macromedia Flash MX automatically changes the unloadMovie action to the unloadMovieNum action in the Actions panel Script pane. When the Actions panel is in expert mode, you cannot specify a level with the unloadMovie action. You must use unloadMovieNum instead.

target The target path of a movie clip.

Returns

None.

Description

Action; removes a loaded movie or a movie clip from the Flash Player. To unload a movie that was loaded into a level in the Flash Player, use the level parameter. To unload a loaded movie clip, use the target parameter.

When you use the unloadMovie action with the Actions panel in normal mode, you can specify either a level in the Flash Player or a target movie clip, from which the movie will be unloaded. If a movie is loaded into a target movie clip, you can use the target path of that movie clip to target the movie to be unloaded. If you specify a level, the action changes to unloadMovieNum.

When you use the unloadMovie action with the Actions panel in expert mode, you can specify the target parameter, but you cannot specify the level parameter. You must use the unloadMovieNum action to specify a level in expert mode.

Example

The following example unloads the movie clip draggable on the main Timeline, and loads the movie movie.swf into level 4.

on (press) {
    unloadMovie ("_root.draggable");
    loadMovieNum ("movie.swf", 4);
}

The following example unloads the movie loaded into level 4:

on (press) {
    unloadMovieNum (4);
}

See also

loadMovie, loadMovieNum, unloadMovieNum