G-L > loadMovie |
![]() ![]() ![]() |
loadMovie
loadmovie
Availability
Flash Player 3.
Usage
loadMovie(
"url
",level
/
target
[,
variables
])
Parameters
url
The absolute or relative URL of the SWF file or JPEG file to be loaded. A relative path must be relative to the SWF file at level 0. The URL must be in the same subdomain as the URL where the movie currently resides. For use in the Flash Player or for testing in test mode in the Flash authoring application, all SWF files must be stored in the same folder, and the filenames cannot include folder or disk drive specifications.
target
A path to a target movie clip. The target movie clip will be replaced by the loaded movie or image. When the Actions panel is in normal mode, you can specify either a target
movie clip or a level
of a target movie; you can't specify both.
level
An integer specifying the level in the Flash Player into which the movie will be loaded. The level
parameter is vailable with the loadMovie
action only when the Actions panel is in normal mode. If you select a level
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 unloadMovie
. You must use unloadMovieNum
instead.
variables
An optional parameter specifying an HTTP method for sending variables. (In expert mode, the variables
parameter is identified as the method
parameter.) The parameter must be the string GET
or POST
. If there are no variables to be sent, omit this parameter. The GET
method appends the variables to the end of the URL, and is used for small numbers of variables. The POST
method sends the variables in a separate HTTP header and is used for long strings of variables.
Returns
Nothing.
Description
Action; load a SWF or JPEG file into the Flash Player while the original movie is playing. The loadMovie
action lets you display several movies at once and switch between movies without loading another HTML document. Without the loadMovie
action, the Flash Player displays a single movie (SWF file) and then closes.
When you use the loadMovie
action with the Actions panel in normal mode, you can specify either a level in the Flash Player or a target movie clip, into which the movie will load. If a movie is loaded into a target movie clip, you can use the target path of that movie clip to target the loaded movie. If you specify a level, the action changes to loadMovieNum
.
When you use the loadMovie
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 loadMovieNum
action to specify a level in expert mode.
A movie or image loaded into a target inherits the position, rotation, and scale properties of the targeted movie clip. The upper left corner of the loaded image or movie aligns with the registration point of the targeted movie clip. Alternatively, if the target is the _root
Timeline, the upper left corner of the image or movie aligns with the upper left corner of the Stage.
Use the unloadMovie
action to remove movies loaded with the loadMovie
action.
Example
The following loadMovie
statement is attached to a navigation button labeled Products. There is an invisible movie clip on the Stage with the instance name dropZone.
The loadMovie
action uses this movie clip as the target parameter to load the products in the SWF file, into the correct position on the Stage.
on(release) { loadMovie("products.swf",_root.dropZone); }
The following example loads a JPEG image from the same directory as the SWF File that calls the loadMovie
action:
loadMovie("image45.jpeg", "ourMovieClip");
See also
loadMovieNum
, unloadMovie
, unloadMovieNum
,
_level
![]() ![]() ![]() |