Package | com.greensock.loading |
Class | public class SelfLoader |
Inheritance | SelfLoader ![]() ![]() ![]() |
loaderInfo
's progress). SelfLoader is only useful in situations where you want to factor
the current swf's loading progress into a LoaderMax queue or maybe display a progress bar for the current
swf or fire an event when loading has finished.
OPTIONAL VARS PROPERTIES
The following special properties can be passed into the SelfLoader constructor via its vars
parameter:
LoaderMax.getLoader()
or LoaderMax.getContent()
methods or traced at any time. Each loader's name should be unique. If you don't define one, a unique name will be created automatically, like "loader21".autoDispose
is true
, the loader will be disposed immediately after it completes (it calls the dispose()
method internally after dispatching its COMPLETE
event). This will remove any listeners that were defined in the vars object (like onComplete, onProgress, onError). Once a loader is disposed, it can no longer be found with LoaderMax.getLoader()
or LoaderMax.getContent()
. The default autoDispose
value is false
.
----EVENT HANDLER SHORTCUTS----
LoaderEvent.PROGRESS
events which are dispatched whenever the bytesLoaded
changes. Make sure your onProgress function accepts a single parameter of type LoaderEvent
(com.greensock.events.LoaderEvent
). You can use the LoaderEvent's target.progress
to get the loader's progress value or use its target.bytesLoaded
and target.bytesTotal
.LoaderEvent.COMPLETE
events which are dispatched when the loader has finished loading successfully. Make sure your onComplete function accepts a single parameter of type LoaderEvent
(com.greensock.events.LoaderEvent
).import com.greensock.loading.*; import com.greensock.events.LoaderEvent; //create a SelfLoader var loader:SelfLoader = new SelfLoader(this, {name:"self", onProgress:progressHandler, onComplete:completeHandler}); //Or you could put the SelfLoader into a LoaderMax. Create one first... var queue:LoaderMax = new LoaderMax({name:"mainQueue", onProgress:progressHandler, onComplete:completeHandler, onError:errorHandler}); //append the SelfLoader and several other loaders queue.append( loader ); queue.append( new ImageLoader("images/photo1.jpg", {name:"photo1", container:this}) ); queue.append( new SWFLoader("swf/child.swf", {name:"child", container:this, x:100, estimatedBytes:3500}) ); //start loading the LoaderMax queue queue.load(); function progressHandler(event:LoaderEvent):void { trace("progress: " + event.target.progress); } function completeHandler(event:LoaderEvent):void { trace(event.target + " complete"); } function errorHandler(event:LoaderEvent):void { trace("error occured with " + event.target + ": " + event.text); }
Copyright 2010-2013, GreenSock. All rights reserved. This work is subject to the terms in http://www.greensock.com/terms_of_use.html or for Club GreenSock members, the software agreement that was issued with the membership.
Method | Defined By | ||
---|---|---|---|
SelfLoader(self:DisplayObject, vars:Object = null)
Constructor
| SelfLoader | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [override] | LoaderCore | |
![]() | auditSize():void [override]
Attempts loading just enough of the content to accurately determine the bytesTotal
in order to improve the accuracy of the progress property. | LoaderItem | |
![]() | cancel():void
If the loader is currently loading (status is LoaderStatus.LOADING), it will be canceled
immediately and its status will change to LoaderStatus.READY. | LoaderCore | |
![]() | dispose(flushContent:Boolean = false):void
Disposes of the loader and releases it internally for garbage collection. | LoaderCore | |
![]() | load(flushContent:Boolean = false):void
Loads the loader's content, optionally flushing any previously loaded content first. | LoaderCore | |
![]() | pause():void Pauses the loader immediately. | LoaderCore | |
![]() | prioritize(loadNow:Boolean = true):void
Immediately prioritizes the loader inside any LoaderMax instances that contain it,
forcing it to the top position in their queue and optionally calls load()
immediately as well. | LoaderCore | |
![]() | resume():void Unpauses the loader and resumes loading immediately. | LoaderCore | |
![]() | toString():String [override] Returns information about the loader, like its type, its name, and its url (if it has one). | LoaderCore | |
![]() | unload():void
Removes any content that was loaded and sets bytesLoaded back to zero. | LoaderCore |
SelfLoader | () | Constructor |
public function SelfLoader(self:DisplayObject, vars:Object = null)
Constructor
Parametersself:DisplayObject — A DisplayObject from the main swf (it will use this DisplayObject's loaderInfo to track the loading progress).
| |
vars:Object (default = null ) — An object containing optional configuration details. For example: new SelfLoader(this, {name:"self", onComplete:completeHandler, onProgress:progressHandler}) .
The following special properties can be passed into the constructor via the
|