MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT Reference Manual page 443

LocalConnection.onStatus
Availability
Flash Player 6.
Usage
sending_lc.onStatus = function(infoObject) {
// your statements here
}
Parameters
A parameter defined according to the status message. For details about this
infoObject
parameter, see "Description," below.
Returns
Nothing.
Description
Event handler; invoked after a sending LocalConnection object tries to send a command to a
receiving LocalConnection object. If you want to respond to this event handler, you must create a
function to process the information object sent by the LocalConnection object.
If the information object returned by this event handler contains a
Flash successfully sent the command to a receiving LocalConnection object. This does not mean
that Flash successfully invoked the specified method of the receiving LocalConnection object,
only that Flash was able to send the command. For example, the method is not invoked if the
receiving LocalConnection object doesn't allow connections from the sending domain, or if the
method does not exist. The only way to know for sure if the method was invoked is to have the
receiving object send a reply to the sending object.
If the information object returned by this event handler contains a
was unable to send the command to a receiving LocalConnection object, most likely because
there is no receiving LocalConnection object connected whose name corresponds to the name
specified in the
sending_lc.send()
In addition to this
System.onStatus. If
to respond to it, Flash processes a function assigned to
In most cases, you will implement this handler only to respond to error conditions, as shown in
the following example.
Example
The following example displays information about a failed connection in the Output panel:
sending_lc = new LocalConnection();
sending_lc.onStatus = function(infoObject)
{
if (infoObject.level == "Error")
{
trace("Connection failed.");
}
}
sending_lc.send("receiving_lc", "methodName");
command that invoked this handler.
handler, Flash also provides a "super" function called
onStatus
is invoked for a particular object and there is no function assigned
onStatus
value of
level
value of
level
if it exists.
System.onStatus
LocalConnection.onStatus
,
"Status"
, Flash
"Error"
443