MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT, Reference Manual

Page: 402 / 816

402 Chapter 12: ActionScript Dictionary
Description
Compiler directive: includes the contents of the specified file, as if the commands in the file were
part of the calling script itself. 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 the same directory as the FLA file or the
script containing the
#include
statement.
•
To specify a path for the AS file relative to the FLA file or script, use a single dot (.) to indicate
the current directory, two dots (
..
) to indicate a parent directory, and forward slashes (
/
). See
the following examples.
•
To specify an absolute path for the AS file, use the format supported by your platform
(Macintosh or Windows). See the following examples. However, this usage is not
recommended, because it requires that the directory structure be the same on any machine you
use to compile the script.
Example
The following examples show various ways of specifying a path for a file to be included in
your script.
// Note that #include statements do not end with a semicolon (;)
// AS file is in same directory as FLA file or script
#include "init_script.as"
// AS file is in a subdirectory of the directory
// containing the FLA file or script
// The subdirectory is named "FLA_includes"
#include "FLA_includes/init_script.as"
// AS file is in a directory at the same level as the FLA file or script
// The directory is named "ALL_includes"
#include "../ALL_includes/init_script.as"
// AS file is specified by an absolute path in Windows
// Note use of forward slashes, not backslashes
#include "C:/Flash_scripts/init_script.as"
// AS file is specified by an absolute path on Macintosh
#include "Mac HD:Flash_scripts:init_script.as"
See also
import