User Guide

1016 ProgressBar component
ProgressBar.progress
Availability
Flash Player 6 (6.0.79.0).
Edition
Flash MX 2004.
Usage
Usage 1:
var listenerObject:Object = new Object();
listenerObject.progress = function(eventObject:Object) {
// ...
};
progressBarInstance.addEventListener("progress", listenerObject);
Usage 2:
on (progress) {
// ...
}
Event object
In addition to the standard event object properties, there are two additional properties defined
for the
ProgressBar.progress event: current (the loaded value equals total), and total
(the total value).
Description
Event; broadcast to all registered listeners whenever the value of a progress bar changes.
The first usage example uses a dispatcher/listener event model. A component instance
(
progressBarInstance) dispatches an event (in this case, progress) and the event is
handled by a function, also called a handler, on a listener object (
listenerObject) that you
create. You define a method with the same name as the event on the listener object; the
method is called when the event is triggered. When the event is triggered, it automatically
passes an event object (
eventObject) to the listener object method. Each event object has
properties that contain information about the event. You can use these properties to write
code that handles the event. Finally, you call the
EventDispatcher.addEventListener()
method on the component instance that broadcasts the event to register the listener with the
instance. When the instance dispatches the event, the listener is called.
For more information, see “EventDispatcher class” on page 499.