Package | flash.display |
Class | public class LoaderInfo |
Inheritance | LoaderInfo EventDispatcher Object |
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
You can access LoaderInfo objects in two ways:
- The
contentLoaderInfo
property of a flash.display.Loader object— ThecontentLoaderInfo
property is always available for any Loader object. For a Loader object that has not called theload()
orloadBytes()
method, or that has not sufficiently loaded, attempting to access many of the properties of thecontentLoaderInfo
property throws an error. - The
loaderInfo
property of a display object.
The contentLoaderInfo
property of a Loader object provides information about
the content that the Loader object is loading, whereas the loaderInfo
property of
a DisplayObject provides information about the root SWF file for that display object.
When you use a Loader object to load a display object (such as a SWF file or a bitmap), the
loaderInfo
property of the display object is the same as the contentLoaderInfo
property of the Loader object (DisplayObject.loaderInfo = Loader.contentLoaderInfo
).
Because the instance of the main class of the SWF file has
no Loader object, the loaderInfo
property is the only way to
access the LoaderInfo for the instance of the main class of the SWF file.
The following diagram shows the different uses of the LoaderInfo object—for the instance of the main class of
the SWF file, for the contentLoaderInfo
property of a Loader object, and for the loaderInfo
property of a loaded object:
When a loading operation is not complete, some properties of the contentLoaderInfo
property of a Loader object are not available. You can obtain some properties, such as
bytesLoaded
, bytesTotal
, url
, loaderURL
,
and applicationDomain
. When the loaderInfo
object dispatches the
init
event, you can access all properties of the loaderInfo
object and
the loaded image or SWF file.
Note: All properties of LoaderInfo objects are read-only.
The EventDispatcher.dispatchEvent()
method
is not applicable to LoaderInfo objects. If you call dispatchEvent()
on a LoaderInfo object, an IllegalOperationError exception is thrown.
See also
flash.display.Loader.content
flash.display.DisplayObject
flash.display.DisplayObject.loaderInfo
Property | Defined By | ||
---|---|---|---|
actionScriptVersion : uint [read-only]
The ActionScript version of the loaded SWF file. | LoaderInfo | ||
applicationDomain : ApplicationDomain [read-only]
When an external SWF file is loaded, all ActionScript 3.0 definitions contained in the loaded
class are stored in the applicationDomain property. | LoaderInfo | ||
bytes : ByteArray [read-only]
The bytes associated with a LoaderInfo object. | LoaderInfo | ||
bytesLoaded : uint [read-only]
The number of bytes that are loaded for the media. | LoaderInfo | ||
bytesTotal : uint [read-only]
The number of compressed bytes in the entire media file. | LoaderInfo | ||
childAllowsParent : Boolean [read-only]
Expresses the trust relationship from content (child) to the Loader (parent). | LoaderInfo | ||
childSandboxBridge : Object
A object that can be set by the loaded content's code to expose properties and methods that can be accessed
by code in the Loader object's sandbox. | LoaderInfo | ||
constructor : Object
A reference to the class object or constructor function for a given object instance. | Object | ||
content : DisplayObject [read-only]
The loaded object associated with this LoaderInfo object. | LoaderInfo | ||
contentType : String [read-only]
The MIME type of the loaded file. | LoaderInfo | ||
frameRate : Number [read-only]
The nominal frame rate, in frames per second, of the loaded SWF file. | LoaderInfo | ||
height : int [read-only]
The nominal height of the loaded file. | LoaderInfo | ||
loader : Loader [read-only]
The Loader object associated with this LoaderInfo object. | LoaderInfo | ||
loaderURL : String [read-only]
The URL of the SWF file that initiated the loading of the media
described by this LoaderInfo object. | LoaderInfo | ||
parameters : Object [read-only]
An object that contains name-value pairs that represent the parameters provided
to the loaded SWF file. | LoaderInfo | ||
parentAllowsChild : Boolean [read-only]
Expresses the trust relationship from Loader (parent) to the content (child). | LoaderInfo | ||
parentSandboxBridge : Object
A object that can be set by code in the Loader object's sandbox to expose properties and methods that can be accessed
by the loaded content's code. | LoaderInfo | ||
prototype : Object [static]
A reference to the prototype object of a class or function object. | Object | ||
sameDomain : Boolean [read-only]
Expresses the domain relationship between the loader and the content: true if they have
the same origin domain; false otherwise. | LoaderInfo | ||
sharedEvents : EventDispatcher [read-only]
An EventDispatcher instance that can be used to exchange events across security boundaries. | LoaderInfo | ||
swfVersion : uint [read-only]
The file format version of the loaded SWF file. | LoaderInfo | ||
url : String [read-only]
The URL of the media being loaded. | LoaderInfo | ||
width : int [read-only]
The nominal width of the loaded content. | LoaderInfo |
Method | Defined By | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener
receives notification of an event. | EventDispatcher | ||
[static]
Returns the LoaderInfo object associated with a SWF file defined as an object. | LoaderInfo | ||
Checks whether the EventDispatcher object has any listeners registered for a specific type
of event. | EventDispatcher | ||
Indicates whether an object has a specified property defined. | Object | ||
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | ||
Indicates whether the specified property exists and is enumerable. | Object | ||
Removes a listener from the EventDispatcher object. | EventDispatcher | ||
Sets the availability of a dynamic property for loop operations. | Object | ||
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | ||
Returns the string representation of the specified object. | Object | ||
Returns the primitive value of the specified object. | Object | ||
Checks whether an event listener is registered with this EventDispatcher object or any of
its ancestors for the specified event type. | EventDispatcher |
Event | Summary | Defined By | ||
---|---|---|---|---|
[broadcast event] Dispatched when the Flash Player or AIR application gains operating system focus and becomes active. | EventDispatcher | |||
Dispatched when data has loaded successfully. | LoaderInfo | |||
[broadcast event] Dispatched when the Flash Player or AIR application operating loses system focus and is becoming inactive. | EventDispatcher | |||
Dispatched when a network request is made over HTTP and an HTTP status code can be detected. | LoaderInfo | |||
Dispatched when the properties and methods of a loaded SWF file are accessible and ready for use. | LoaderInfo | |||
Dispatched when an input or output error occurs that causes a load operation to fail. | LoaderInfo | |||
Dispatched when a load operation starts. | LoaderInfo | |||
Dispatched when data is received as the download operation progresses. | LoaderInfo | |||
Dispatched by a LoaderInfo object whenever a loaded object is removed by using the unload() method of the Loader object, or when a second load is performed by the same Loader object and the original content is removed prior to the load beginning. | LoaderInfo |
actionScriptVersion | property |
actionScriptVersion:uint
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
The ActionScript version of the loaded SWF file.
The language version is specified by using the enumerations in the
ActionScriptVersion class, such as ActionScriptVersion.ACTIONSCRIPT2
and ActionScriptVersion.ACTIONSCRIPT3
.
Note: This property always has a value of either ActionScriptVersion.ACTIONSCRIPT2
or
ActionScriptVersion.ACTIONSCRIPT3
. ActionScript 1.0 and 2.0 are
both reported as ActionScriptVersion.ACTIONSCRIPT2
(version 2.0). This property
only distinguishes ActionScript 1.0 and 2.0 from ActionScript 3.0.
Implementation
public function get actionScriptVersion():uint
Throws
Error — If the file is not downloaded sufficiently to retrieve the requested information.
| |
Error — If the file is not a SWF file.
|
See also
applicationDomain | property |
applicationDomain:ApplicationDomain
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
When an external SWF file is loaded, all ActionScript 3.0 definitions contained in the loaded
class are stored in the applicationDomain
property.
All code in a SWF file is defined to exist in an application domain. The current application domain is where your main application runs. The system domain contains all application domains, including the current domain and all classes used by Flash Player or Adobe AIR.
All application domains, except the system domain, have an associated parent domain.
The parent domain of your main application's applicationDomain
is the system domain.
Loaded classes are defined only when their parent doesn't already define them.
You cannot override a loaded class definition with a newer definition.
For usage examples of application domains, see the "Client System Environment" chapter in Programming ActionScript 3.0.
Implementation
public function get applicationDomain():ApplicationDomain
Throws
SecurityError — This security sandbox of the caller is not allowed to access this ApplicationDomain.
|
See also
bytes | property |
bytes:ByteArray
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9.0.115.0 |
The bytes associated with a LoaderInfo object.
Implementation
public function get bytes():ByteArray
Throws
SecurityError — If the object accessing this API is prevented from
accessing the loaded object due to security restrictions. This situation can occur,
for instance, when a Loader object attempts to access the contentLoaderInfo.content
property and it is not granted security permission to access the loaded content.
For more information, see the "Flash Player Security" chapter in Programming ActionScript 3.0. |
bytesLoaded | property |
bytesLoaded:uint
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
The number of bytes that are loaded for the media. When this number equals
the value of bytesTotal
, all of the bytes are loaded.
Implementation
public function get bytesLoaded():uint
bytesTotal | property |
bytesTotal:uint
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
The number of compressed bytes in the entire media file.
Before the first progress
event is dispatched by
this LoaderInfo object's corresponding Loader object, bytesTotal
is 0.
After the first progress
event from the Loader object, bytesTotal
reflects the actual number of bytes to be downloaded.
Implementation
public function get bytesTotal():uint
See also
childAllowsParent | property |
childAllowsParent:Boolean
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
Expresses the trust relationship from content (child) to the Loader (parent).
If the child has allowed the parent access, true
; otherwise,
false
. This property is set to true
if the child object
has called the allowDomain()
method to grant permission to the parent domain
or if a URL policy is loaded at the child domain that grants permission
to the parent domain. If child and parent are in
the same domain, this property is set to true
.
For more information, see the "Flash Player Security" chapter in Programming ActionScript 3.0.
Implementation
public function get childAllowsParent():Boolean
Throws
Error — Thrown if the file is not downloaded sufficiently
to retrieve the requested information.
|
childSandboxBridge | property |
childSandboxBridge:Object
Runtime Versions: | AIR 1.0 |
A object that can be set by the loaded content's code to expose properties and methods that can be accessed by code in the Loader object's sandbox. This sandbox bridge lets content from a non-application domain have controlled access to scripts in the AIR application sandbox, and vice versa. The sandbox bridge serves as a gateway between the sandboxes, providing explicit interaction between application and non-application security sandboxes.
Implementation
public function get childSandboxBridge():Object
public function set childSandboxBridge(value:Object):void
Throws
SecurityError — Only content in the loaded content's sandbox can set this property.
|
See also
content | property |
content:DisplayObject
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
The loaded object associated with this LoaderInfo object.
Implementation
public function get content():DisplayObject
Throws
SecurityError — If the object accessing this API is prevented from
accessing the loaded object due to security restrictions. This situation can occur,
for instance, when a Loader object attempts to access the contentLoaderInfo.content
property and it is not granted security permission to access the loaded content.
For more information, see the "Flash Player Security" chapter in Programming ActionScript 3.0. |
contentType | property |
contentType:String
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
The MIME type of the loaded file. The value is null
if not enough of the file has loaded
in order to determine the type. The following list gives the possible values:
"application/x-shockwave-flash"
"image/jpeg"
"image/gif"
"image/png"
Implementation
public function get contentType():String
frameRate | property |
frameRate:Number
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
The nominal frame rate, in frames per second, of the loaded SWF file. This number is often an integer, but need not be.
This value may differ from the actual frame rate in use. Flash Player or Adobe AIR only uses a single frame rate for all loaded SWF files at any one time, and this frame rate is determined by the nominal frame rate of the main SWF file. Also, the main frame rate may not be able to be achieved, depending on hardware, sound synchronization, and other factors.
Implementation
public function get frameRate():Number
Throws
Error — If the file is not downloaded sufficiently to retrieve the requested information.
| |
Error — If the file is not a SWF file.
|
height | property |
height:int
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
The nominal height of the loaded file. This value might differ from the actual height at which the content is displayed, since the loaded content or its parent display objects might be scaled.
Implementation
public function get height():int
Throws
Error — If the file is not downloaded sufficiently to retrieve the requested information.
|
loader | property |
loader:Loader
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
The Loader object associated with this LoaderInfo object. If this LoaderInfo object
is the loaderInfo
property of the instance of the main class of the SWF file, no
Loader object is associated.
Implementation
public function get loader():Loader
Throws
SecurityError — If the object accessing this API is prevented from
accessing the Loader object because of security restrictions. This can occur,
for instance, when a loaded SWF file attempts to access its loaderInfo.loader
property and it is not granted security permission to access the loading SWF file.
For more information, see the "Flash Player Security" chapter in Programming ActionScript 3.0. |
loaderURL | property |
loaderURL:String
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
The URL of the SWF file that initiated the loading of the media described by this LoaderInfo object. For the instance of the main class of the SWF file, this URL is the same as the SWF file's own URL.
Implementation
public function get loaderURL():String
parameters | property |
parameters:Object
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
An object that contains name-value pairs that represent the parameters provided to the loaded SWF file.
You can use a for-in
loop to extract all the names and values
from the parameters
object.
The two sources of parameters are: the query string in the
URL of the main SWF file, and the value of the FlashVars
HTML parameter (this affects
only the main SWF file).
The parameters
property replaces the ActionScript 1.0 and 2.0 technique of
providing SWF file parameters as properties of the main timeline.
The value of the parameters
property is null for Loader objects
that contain SWF files that use ActionScript 1.0 or 2.0. It is only
non-null for Loader objects that contain SWF files that use ActionScript 3.0.
Implementation
public function get parameters():Object
parentAllowsChild | property |
parentAllowsChild:Boolean
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
Expresses the trust relationship from Loader (parent) to the content (child).
If the parent has allowed the child access, true
; otherwise,
false
. This property is set to true
if the parent object
called the allowDomain()
method to grant permission to the child domain
or if a URL policy file is loaded at the parent domain granting permission
to the child domain. If child and parent are in
the same domain, this property is set to true
.
For more information, see the "Flash Player Security" chapter in Programming ActionScript 3.0.
Implementation
public function get parentAllowsChild():Boolean
Throws
Error — Thrown if the file is not downloaded sufficiently
to retrieve the requested information.
|
parentSandboxBridge | property |
parentSandboxBridge:Object
Runtime Versions: | AIR 1.0 |
A object that can be set by code in the Loader object's sandbox to expose properties and methods that can be accessed by the loaded content's code. This sandbox bridge lets content from a non-application domain have controlled access to scripts in the AIR application sandbox, and vice versa. The sandbox bridge serves as a gateway between the sandboxes, providing explicit interaction between application and non-application security sandboxes.
Implementation
public function get parentSandboxBridge():Object
public function set parentSandboxBridge(value:Object):void
Throws
SecurityError — Only content in the Loader object's sandbox can set this property.
|
See also
sameDomain | property |
sameDomain:Boolean
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
Expresses the domain relationship between the loader and the content: true
if they have
the same origin domain; false
otherwise.
Implementation
public function get sameDomain():Boolean
Throws
Error — Thrown if the file is not downloaded sufficiently
to retrieve the requested information.
|
sharedEvents | property |
sharedEvents:EventDispatcher
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
An EventDispatcher instance that can be used to exchange events across security boundaries.
Even when the Loader object and the loaded content originate from security domains that do not trust
one another, both can access sharedEvents
and send and receive events via this object.
Implementation
public function get sharedEvents():EventDispatcher
swfVersion | property |
swfVersion:uint
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
The file format version of the loaded SWF file.
The file format is specified using the enumerations in the
SWFVersion class, such as SWFVersion.FLASH7
and SWFVersion.FLASH9
.
Implementation
public function get swfVersion():uint
Throws
Error — If the file is not downloaded sufficiently to retrieve the requested information.
| |
Error — If the file is not a SWF file.
|
See also
url | property |
url:String
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
The URL of the media being loaded.
Before the first progress
event is dispatched by this LoaderInfo
object's corresponding Loader object, the value of the url
property
might reflect only the initial URL specified in the call to the load()
method of the Loader object. After the first progress
event, the
url
property reflects the media's final URL, after any redirects and relative
URLs are resolved.
Implementation
public function get url():String
See also
width | property |
width:int
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
The nominal width of the loaded content. This value might differ from the actual width at which the content is displayed, since the loaded content or its parent display objects might be scaled.
Implementation
public function get width():int
Throws
Error — If the file is not downloaded sufficiently to retrieve the requested information.
|
getLoaderInfoByDefinition | () | method |
public static function getLoaderInfoByDefinition(object:Object):LoaderInfo
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9.0.115.0 |
Returns the LoaderInfo object associated with a SWF file defined as an object.
Parameters
object:Object — The object for which you want to get an associated LoaderInfo object.
|
LoaderInfo — The associated LoaderInfo object. Returns null when called
in non-debugger builds (or when debugging is not enabled) or if the referenced object
does not have an associated LoaderInfo object (such as some objects used by the AIR runtime).
|
Throws
SecurityError — The caller is not running in the local trusted sandbox.
|
complete | Event |
flash.events.Event
property Event.type =
flash.events.Event.COMPLETE
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
Dispatched when data has loaded successfully. In other words, it is dispatched when all the content
has been downloaded and the loading has finished. The complete
event is always dispatched
after the init
event. The init
event is dispatched when the object
is ready to access, though the content may still be downloading.
Event.COMPLETE
constant defines the value of the type
property of a complete
event object.
This event has the following properties:
Property | Value |
---|---|
bubbles | false |
cancelable | false ; there is no default behavior to cancel. |
currentTarget | The object that is actively processing the Event object with an event listener. |
target | The network object that has completed loading. |
See also
httpStatus | Event |
flash.events.HTTPStatusEvent
property HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
Dispatched when a network request is made over HTTP and an HTTP status code can be detected.
TheHTTPStatusEvent.HTTP_STATUS
constant defines the value of the
type
property of a httpStatus
event object.
This event has the following properties:
Property | Value |
---|---|
bubbles | false |
cancelable | false ; there is no default behavior to cancel. |
currentTarget | The object that is actively processing the Event object with an event listener. |
status | The HTTP status code returned by the server. |
target | The network object receiving an HTTP status code. |
See also
init | Event |
flash.events.Event
property Event.type =
flash.events.Event.INIT
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
Dispatched when the properties and methods of a loaded SWF file are
accessible and ready for use. The content, however, can still be downloading. A LoaderInfo object
dispatches the init
event when the following conditions exist:
- All properties and methods associated with the loaded object and those associated with the LoaderInfo object are accessible.
- The constructors for all child objects have completed.
- All ActionScript code in the first frame of the loaded SWF's main timeline has been executed.
For example, an Event.INIT
is dispatched when the first frame of a movie or animation is loaded.
The movie is then accessible and can be added to the display list. The complete movie, however, can
take longer to download. The Event.COMPLETE
is only dispatched once the full movie is loaded.
The init
event always precedes the complete
event.
Event.INIT
constant defines the value of the type
property of an init
event object.
This event has the following properties:
Property | Value |
---|---|
bubbles | false |
cancelable | false ; there is no default behavior to cancel. |
currentTarget | The object that is actively processing the Event object with an event listener. |
target | The LoaderInfo object associated with the SWF file being loaded. |
See also
ioError | Event |
flash.events.IOErrorEvent
property IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
Dispatched when an input or output error occurs that causes a load operation to fail.
Defines the value of thetype
property of an ioError
event object.
This event has the following properties:
Property | Value |
---|---|
bubbles | false |
cancelable | false ; there is no default behavior to cancel. |
currentTarget | The object that is actively processing the Event object with an event listener. |
errorID | A reference number associated with the specific error (AIR only). |
target | The network object experiencing the input/output error. |
text | Text to be displayed as an error message. |
See also
open | Event |
flash.events.Event
property Event.type =
flash.events.Event.OPEN
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
Dispatched when a load operation starts.
TheEvent.OPEN
constant defines the value of the type
property of an open
event object.
This event has the following properties:
Property | Value |
---|---|
bubbles | false |
cancelable | false ; there is no default behavior to cancel. |
currentTarget | The object that is actively processing the Event object with an event listener. |
target | The network object that has opened a connection. |
See also
progress | Event |
flash.events.ProgressEvent
property ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
Dispatched when data is received as the download operation progresses.
Defines the value of thetype
property of a progress
event object.
This event has the following properties:
Property | Value |
---|---|
bubbles | false |
bytesLoaded | The number of items or bytes loaded at the time the listener processes the event. |
bytesTotal | The total number of items or bytes that ultimately will be loaded if the loading process succeeds. |
cancelable | false ; there is no default behavior to cancel. |
currentTarget | The object that is actively processing the Event object with an event listener. |
target | The object reporting progress. |
See also
unload | Event |
flash.events.Event
property Event.type =
flash.events.Event.UNLOAD
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
Dispatched by a LoaderInfo object whenever a loaded object is removed by using the unload()
method of the Loader object, or when a second load is performed by the same Loader object and the
original content is removed prior to the load beginning.
Event.UNLOAD
constant defines the value of the type
property of an unload
event object.
This event has the following properties:
Property | Value |
---|---|
bubbles | false |
cancelable | false ; there is no default behavior to cancel. |
currentTarget | The object that is actively processing the Event object with an event listener. |
target | The LoaderInfo object associated with the SWF file being unloaded or replaced. |
See also
- A property
url
is created, which is the location and name of the image. - The class constructor creates a Loader object named
loader
. - The
loader
object instantiates an event listener to ensure that the image loads properly. - The constructor creates a new instance of a URLRequest object,
request
, withurl
passed so that the file name and location are known. - The
request
object is then passed to theload()
method of theloader
object, which loads the image onto the display list.
Important: This example requires that you add a file named Image.gif in the same directory as the compiled SWF file. Use an image that has an area that fits within the dimensions of the main SWF file.
package { import flash.display.Loader; import flash.display.LoaderInfo; import flash.display.Sprite; import flash.events.*; import flash.net.URLRequest; public class LoaderInfoExample extends Sprite { private var url:String = "Image.gif"; public function LoaderInfoExample() { var loader:Loader = new Loader(); loader.contentLoaderInfo.addEventListener(Event.INIT, initHandler); loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); var request:URLRequest = new URLRequest(url); loader.load(request); addChild(loader); } private function initHandler(event:Event):void { var loader:Loader = Loader(event.target.loader); var info:LoaderInfo = LoaderInfo(loader.contentLoaderInfo); trace("initHandler: loaderURL=" + info.loaderURL + " url=" + info.url); } private function ioErrorHandler(event:IOErrorEvent):void { trace("ioErrorHandler: " + event); } } }
Fri Mar 19 2010, 02:45 AM -07:00