U-X > unloadMovie |  |

unloadMovie

unloadmovie, unload

Availability

Flash Player 3.

Usage

    unloadMovie[Num](level/"target")

Parameters

`level` The level (`_level` `N`) 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 un`loadMovie` action to the un`loadMovieNum` 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`