onStatus (System.onStatus handler)
onStatus = function(infoObject:Object) {}
Event handler: provides a super event handler for certain objects.
The SharedObject class provides an onStatus() event handler 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 the SharedObject.onStatus() method, Flash also provides a super function called System.onStatus(), which serves as a secondary error message handler. If an instance of the SharedObject class passes an information object with a level property of "error", but you did not define an onStatus() function for that particular instance, then Flash uses the function you define for System.onStatus() instead.
infoObject:Object - A parameter defined according to the status message.
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.");
}