#initclip directive

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

Compiler directive; 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 execute when a movie clip symbol is defined. If the movie clip is an exported symbol, the initialization actions execute before the actions on Frame 1 of the SWF file. Otherwise, they execute immediately before the frame actions of the frame that contains the first instance of the associated movie clip symbol.

Initialization actions execute only once when a SWF file plays; use them for one-time initializations, such as class definition and registration.

Parameters

order - 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--not hexidecimal--values are allowed), 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 inside 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