ACTIONSCRIPT 3.0

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Display programming
applicationDomain: Use this property only when loading a SWF file written in ActionScript 3.0 (not an image or
a SWF file written in ActionScript 1.0 or 2.0). When loading the file, you can specify that the file be included in the
same application domain as that of the Loader object, by setting the applicationDomain parameter to
flash.system.ApplicationDomain.currentDomain. By putting the loaded SWF file in the same application
domain, you can access its classes directly. This can be useful if you are loading a SWF file that contains embedded
media, which you can access via their associated class names. For more information, see “Working with application
domains” on page 147.
Here’s an example of checking for a policy file when loading a bitmap from another domain:
var context:LoaderContext = new LoaderContext();
context.checkPolicyFile = true;
var urlReq:URLRequest = new URLRequest("http://www.[your_domain_here].com/photo11.jpg");
var ldr:Loader = new Loader();
ldr.load(urlReq, context);
Here’s an example of checking for a policy file when loading a SWF from another domain, in order to place the file in
the same security sandbox as the Loader object. Additionally, the code adds the classes in the loaded SWF file to the
same application domain as that of the Loader object:
var context:LoaderContext = new LoaderContext();
context.securityDomain = SecurityDomain.currentDomain;
context.applicationDomain = ApplicationDomain.currentDomain;
var urlReq:URLRequest = new URLRequest("http://www.[your_domain_here].com/library.swf");
var ldr:Loader = new Loader();
ldr.load(urlReq, context);
For more information, see the LoaderContext class in the ActionScript 3.0 Reference for the Adobe Flash Platform.
Loading SWF files in AIR for iOS
Adobe AIR 3.6 and later, iOS only
On iOS devices, there are restrictions on loading and compiling code at runtime. Because of these restrictions, there
are some necessary differences in the task of loading external SWF files into your application:
All SWF files that contain ActionScript code must be included in the application package. No SWF containing code
can be loaded from an external source such as over a network. As part of packaging the application, all ActionScript
code in all SWF files in the application package is compiled to native code for iOS devices.
You can’t load, unload, and then re-load a SWF file. If you attempt to do this, an error occurs.
The behavior of loading into memory and then unloading it is the same as with desktop platforms. If you load a
SWF file then unload it, all visual assets contained in the SWF are unloaded from memory. However, any class
references to an ActionScript class in the loaded SWF remain in memory and can be accessed in ActionScript code.
All loaded SWF files must be loaded in the same application domain as the main SWF file. This is not the default
behavior, so for each SWF you load you must create a LoaderContext object specifying the main application
domain, and pass that LoaderContext object to the Loader.load() method call. If you attempt to load a SWF in an
application domain other than the main SWF application domain, an error occurs. This is true even if the loaded
SWF only contains visual assets and no ActionScript code.
The following example shows the code to use to load a SWF from the application package into the main SWF’s
application domain:
Last updated 4/22/2013
201