|
The
UILoader component is a container that can display SWF, JPEG, progressive JPEG,
PNG, and GIF files. You can use a UILoader whenever you need to
retrieve content from a remote location and pull it into a Flash
application. For example, you could use a UILoader to add a company
logo (JPEG file) to a form. You could also use the UILoader component
in an application that displays photos. Use the
load()
method
to load content, the
percentLoaded
property to
determine how much content has loaded, and the
complete
event
to determine when loading is finished.
You can scale the contents of the UILoader or resize the UILoader
itself to accommodate the size of the contents. By default, the
contents are scaled to fit the UILoader. You can also load content
at run time and monitor loading progress (although after content
has been loaded once it is cached, the progress jumps to 100% quickly).
If you specify a location when loading content in the UILoader, you
must specify the location (X and Y coordinates) as 0, 0.
User interaction with the UILoader component
UILoader component parameters
You can set the following authoring
parameters in the Property inspector or in the Component inspector
for each UILoader component instance:
autoLoad
,
maintainAspectRatio
,
source
,
and
scaleContent
. Each of these parameters has
a corresponding ActionScript property of the same name.
A live preview of each UILoader instance reflects changes made
to parameters in the Property inspector or Component inspector during
authoring.
You can write ActionScript to set additional options for UILoader
instances using its methods, properties, and events. For more information,
see the UILoader class in the
ActionScript 3.0 Reference for the Adobe
Flash Platform
.
Create an application with the UILoader component
The
following procedure explains how to add a UILoader component to
an application while authoring. In this example, the loader loads
a GIF image of a logo.
-
Create a new Flash (ActionScript 3.0) document.
-
Drag a UILoader component from the Components panel to the
Stage.
-
In the Property inspector, enter the instance name
aUI
.
-
Select the loader on the Stage and in the Component inspector,
and enter
http://www.helpexamples.com/images/logo.gif
for
the
source
parameter.
Create a UILoader component instance using ActionScript
This example
creates a UILoader component using ActionScript and loads a JPEG image
of a flower. When the
complete
event occurs, it
displays the number of bytes loaded in the Output panel.
-
Create a new Flash (ActionScript 3.0) document.
-
Drag the UILoader component from the Components panel to
the Library panel.
-
Open the Actions panel, select Frame 1 in the main Timeline,
and enter the following ActionScript code:
import fl.containers.UILoader;
var aLoader:UILoader = new UILoader();
aLoader.source = "http://www.flash-mx.com/images/image1.jpg";
aLoader.scaleContent = false;
addChild(aLoader);
aLoader.addEventListener(Event.COMPLETE, completeHandler);
function completeHandler(event:Event) {
trace("Number of bytes loaded: " + aLoader.bytesLoaded);
}
-
Select Control > Test Movie.
|
|
|
