MACROMEDIA FLEX-FLEX ACTIONSCRIPT LANGUAGE Reference page 406

SharedObject.onStatus
Availability
Flash Player 6.
Usage
myLocalSharedObject.onStatus = function(infoObject:Object) {
// your statements here
}
Parameters
A parameter defined according to the status message.
infoObject
Returns
Nothing.
Description
Event handler; invoked every time an error, warning, or informational note is posted for a shared
object. If you want to respond to this event handler, you must create a function to process the
information object generated by the shared object.
The information object has a
handler, and a
onStatus
In addition to this
System.onStatus
respond to it, Flash processes a function assigned to
The following events notify you when certain SharedObject activities occur:
Code property
SharedObject.Flush.Failed
SharedObject.Flush.Success
Example
The following example displays different messages based on whether the user chooses to allow or
deny the SharedObject object instance to write to the disk.
var message_str:String;
this.createTextField("message_txt", this.getNextHighestDepth(), 0, 0, 300,
22);
message_txt.html = true;
406 Chapter 6: ActionScript Core Classes
property containing a string that describes the result of the
code
property containing a string that is either
level
handler, Flash also provides a super function called
onStatus
. If is invoked for a particular object and no function is assigned to
onStatus
Level property Meaning
Error
Status
System.onStatus,
A
SharedObject.flush()
has failed (the user did not allot
"pending"
additional disk space for the shared object when
Flash Player showed the Local Storage Settings
dialog box).
A
SharedObject.flush()
has been successfully completed
"pending"
(the user allotted additional disk space for the
shared object).
or
"Status" "Error"
if it exists.
command that returned
command that returned
.