User Guide

330 Chapter 2: ActionScript Language Reference
#include
Availability
Flash Player 4.
Usage
#include "[path] filename.as"
Note: Do not place a semicolon (;) at the end of the line that contains the #include statement.
Parameters
[path] filename.as
The filename and optional path for the script to add to the Actions panel
or to the current script; .as is the recommended filename extension.
Returns
Nothing.
Description
Compiler directive: includes the contents of the specified file, as if the commands in the file are
part of the calling script. The
#include directive is invoked at compile time. Therefore, if you
make any changes to an external file, you must save the file and recompile any FLA files that use
it.
If you use the Check Syntax button for a script that contains
#include statements, the syntax of
the included files is also checked.
You can use
#include in FLA files and in external script files, but not in ActionScript 2.0
class files.
You can specify no path, a relative path, or an absolute path for the file to be included. If you
don’t specify a path, the AS file must be in one of the following locations:
• The same directory as the FLA file
• The same directory as the script containing the #include statement
• The global Include directory, which is one of the following:
■ Windows 2000 or Windows XP: C:\Documents and Settings\user\Local Settings\
Application Data\Macromedia\Flash MX 2004\language\Configuration\Include
■ Windows 98: C:\Windows\Application Data\Macromedia\Flash MX 2004\
language\Configuration\Include
■ Macintosh OS X: Hard Drive/Users/Library/Application Support/Macromedia/
Flash MX 2004/language/Configuration/Include
• The Flash MX 2004 program\language\First Run\Include directory; if you save a file here, it is
copied to the global Include directory the next time you start Flash.
To specify a relative path for the AS file, use a single dot (.) to indicate the current directory, two
dots (
..) to indicate a parent directory, and forward slashes (/) to indicate subdirectories. See the
following example section.
CHAPTER 2
ActionScript Language Reference