User Guide

Adding parameters to dynamically created movie clips 213
7. If you don’t want the movie clip to load before the first frame, deselect the Export in First
Frame option.
If you deselect this option, place an instance of the movie clip on the frame of the Timeline
where you want it to be available. For example, if the script you’re writing doesn’t reference the
movie clip until Frame 10, then place an instance of the symbol at or before Frame 10 on
the Timeline.
8. Click OK.
After you’ve assigned a linkage identifier to a movie clip, you can attach an instance of the symbol
to the Stage at runtime by using
attachMovie().
To attach a movie clip to another movie clip:
1. Assign a linkage identifier to a movie clip library symbol, as described in the previous example.
2. With the Actions panel open (Window > Development Panels > Actions), select a frame in
the Timeline.
3. In the Actions panel’s Script pane, type the name of the movie clip or level to which you want
to attach the new movie clip. For example, to attach the movie clip to the root Timeline,
type this.
4. In the Actions toolbox (at the left of the Actions panel), click Built-in Classes > Movie >
MovieClip > Methods, and select
attachMovie().
5. Using the code hints that appear as a guide, enter values for the following parameters:
■ For idName, specify the identifier you entered in the Linkage Properties dialog box.
■ For newName, enter an instance name for the attached clip so that you can target it.
■ For depth, enter the level at which the duplicate movie clip will be attached to the movie
clip. Each attached movie clip has its own stacking order, with level 0 as the level of the
originating movie clip. Attached movie clips are always on top of the original movie clip, as
shown in the following example:
this.attachMovie("calif_id", "california_mc", 10);
For more information, see MovieClip.attachMovie() in Flash ActionScript Language Reference.
Adding parameters to dynamically created movie clips
When you create or duplicate a movie clip dynamically using MovieClip.attachMovie() and
MovieClip.duplicateMovie(), you can populate the movie clip with parameters from another
object. The
initObject parameter of attachMovie() and duplicateMovie() allows
dynamically created movie clips to receive clip parameters.
For more information, see
MovieClip.attachMovie() and
MovieClip.duplicateMovieClip() in Flash ActionScript Language Reference.