System.onstatus - MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Reference

System.onStatus

Availability
Flash Player 6.
Usage
System.onStatus = function(InfoObject:Object) {
// your statements
}
Description
Event handler: provides a super event handler for certain objects.
The LocalConnection, NetStream, and SharedObject classes provide an
that uses an information object for providing information, status, or error messages. To respond
to this event handler, you must create a function to process the information object, and you must
know the format and contents of the returned information object.
In addition to these specific
System.onStatus
LocalConnection, NetStream, or SharedObject class passes an information object with a level
property of "error", but you have not defined an
then Flash uses the function you define for
Note: The Camera and Microphone classes also have
objects with a level property of "error". Therefore,
a function for these handlers.
Example
The following example shows how to create a
objects when a class-specific
// 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
Camera.onStatus, LocalConnection.onStatus, Microphone.onStatus,
NetStream.onStatus,
methods, Flash also provides a super function called
onStatus
, which serves as a secondary error message handler. If an instance of the
function does not exist:
onStatus
SharedObject.onStatus
function for that particular instance,
onStatus
instead.
System.onStatus
handlers but do not pass information
onStatus
System.onStatus
function to process information
System.onStatus
event handler
onStatus
is not called if you don't specify
System.onStatus 853