MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE, Reference

Page: 1158 / 1378

1158 ActionScript classes
In addition to these specific onStatus methods, Flash also provides a super function called
System.onStatus
, which serves as a secondary error message handler. If an instance of the
LocalConnection, NetStream, or SharedObject class passes an information object with a level
property of "error", but you have not defined an onStatus function for that particular
instance, then Flash uses the function you define for
System.onStatus
instead.
Availability: ActionScript 1.0; Flash Player 6
Parameters
infoObject :Object
- A parameter defined according to the status message.
Example
The following example shows how to create a System.onStatus function to process
information objects when a class-specific onStatus function does not exist:
// Create generic function
System.onStatus = function(genericError:Object){
// Your script would do something more meaningful here
trace("An error has occurred. Please try again.");
}
The following example shows how to create an onStatus function for an instance of the
NetStream class:
// Create function for NetStream object
videoStream_ns.onStatus = function(infoObject:Object) {
if (infoObject.code == "NetStream.Play.StreamNotFound") {
trace("Could not find video file.");
}
}
See also
onStatus (Camera.onStatus handler)
,
onStatus (LocalConnection.onStatus
handler)
,
onStatus (Microphone.onStatus handler)
,
onStatus
(NetStream.onStatus handler)
,
onStatus (SharedObject.onStatus handler)
NO
TE
The Camera and Microphone classes also have
onStatus
handlers but do not pass
information objects with a level property of "error". Therefore,
System.onStatus
is not
called if you don't specify a function for these handlers.