#initclip directive

#initclip [order:Number]

Indicates the beginning of a block of initialization actions. When multiple clips are initialized at the same time, you can use the order parameter to specify which initialization occurs first. Initialization actions are executed when a movie clip symbol is defined. If the movie clip is an exported symbol, the initialization actions are executed before the actions on Frame 1 of the SWF file. Otherwise, they are executed immediately before the actions of the frame that contains the first instance of the associated movie clip symbol.

Initialization actions are executed only once when a SWF file is played. Use them for one-time initializations, such as class definition and registration.

Do not place a semicolon (;) at the end of the line that contains the #initclip directive.

Availability: ActionScript 1.0; Flash Player 6.0

Parameters

order:Number [optional] - A non-negative integer that specifies the execution order of blocks of #initclip code. This is an optional parameter. You must specify the value by using an integer literal (only decimal values are allowed, not hexadecimal), and not by using a variable. If you include multiple #initclip blocks in a single movie clip symbol, then the compiler uses the last order value specified in that movie clip symbol for all #initclip blocks in that symbol.

Example

In the following example, ActionScript is placed on Frame 1 in a movie clip instance. A variables.txt text file is placed in the same directory.

#initclip

trace("initializing app");

var variables:LoadVars = new LoadVars();

variables.load("variables.txt");

variables.onLoad = function(success:Boolean) {

 trace("variables loaded:"+success);

 if (success) {
 for (i in variables) {
 trace("variables."+i+" = "+variables[i]);
 }
 }
};

#endinitclip

Flash CS3