User Guide

LocalConnection.send() 341

If the information object returned by this event handler contains a level value of error, Flash

cannot 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() command that invoked this handler.

In addition to this

onStatus handler, Flash also provides a “super” function called

System.onStatus. If onStatus is invoked for a particular object and there is no function

assigned to respond to it, Flash processes a function assigned to

System.onStatus if it exists.

In most cases, you implement this handler only to respond to error conditions, as shown in the

following example.

Example

The following example displays a status message about whether the SWF file connects to another

local connection object called

lc_name. A TextInput component called name_ti, a TextArea

instance called

status_ta and a Button instance called send_button are used to display content.

var sending_lc:LocalConnection;

var sendListener:Object = new Object();

sendListener.click = function(evt:Object) {

sending_lc = new LocalConnection();

sending_lc.onStatus = function(infoObject:Object) {

switch (infoObject.level) {

case 'status' :

status_ta.text = "LocalConnection connected successfully.";

break;

case 'error' :

status_ta.text = "LocalConnection encountered an error.";

break;

}

};

sending_lc.send("lc_name", "sayHello", name_ti.text);

};

send_button.addEventListener("click", sendListener);