ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Display programming
The LoaderInfo object can be accessed as a property of both the Loader object and the loaded display object. As soon
as loading begins, the LoaderInfo object can be accessed through the contentLoaderInfo property of the Loader
object. Once the display object has finished loading, the LoaderInfo object can also be accessed as a property of the
loaded display object through the display object’s loaderInfo property. The loaderInfo property of the loaded
display object refers to the same LoaderInfo object as the contentLoaderInfo property of the Loader object. In other
words, a LoaderInfo object is shared between a loaded object and the Loader object that loaded it (between loader and
loadee).
In order to access properties of loaded content, you will want to add an event listener to the LoaderInfo object, as in
the following code:
import flash.display.Loader;
import flash.display.Sprite;
import flash.events.Event;
var ldr:Loader = new Loader();
var urlReq:URLRequest = new URLRequest("Circle.swf");
ldr.load(urlReq);
ldr.contentLoaderInfo.addEventListener(Event.COMPLETE, loaded);
addChild(ldr);
function loaded(event:Event):void
{
var content:Sprite = event.target.content;
content.scaleX = 2;
}
For more information, see “Handling events” on page 125.
Specifying loading context
Flash Player 9 and later, Adobe AIR 1.0 and later
When you load an external file into Flash Player or AIR through the load() or loadBytes() method of the Loader
class, you can optionally specify a context parameter. This parameter is a LoaderContext object.
The LoaderContext class includes three properties that let you define the context of how the loaded content can be
used:
checkPolicyFile: Use this property only when loading an image file (not a SWF file). If you set this property to
true, the Loader checks the origin server for a policy file (see “Website controls (policy files)” on page 1040). This
is necessary only for content originating from domains other than that of the SWF file containing the Loader object.
If the server grants permission to the Loader domain, ActionScript from SWF files in the Loader domain can access
data in the loaded image; in other words, you can use the BitmapData.draw() command to access data in the
loaded image.
Note that a SWF file from other domains than that of the Loader object can call Security.allowDomain() to
permit a specific domain.
securityDomain: Use this property only when loading a SWF file (not an image). Specify this for a SWF file from
a domain other than that of the file containing the Loader object. When you specify this option, Flash Player checks
for the existence of a policy file, and if one exists, SWF files from the domains permitted in the cross-policy file can
cross-script the loaded SWF content. You can specify flash.system.SecurityDomain.currentDomain as this
parameter.
Last updated 6/6/2012
200