Accessibility
 
Home > Products > Flash > Support > Using ActionScript
Flash Icon Macromedia Flash Support Center - Using ActionScript
LocalConnection.send

Availability
Macromedia Flash Player 6

Usage
sendingLC .send ( connectionName , method [, p1,...,pN])

Parameters
connectionName A string that corresponds to the connectionName specified in the LocalConnection.connect command that wants to communicate with sendingLC .

method A string specifying the name of the method to be invoked in the receiving local connection object. The following method names cause the command to fail: send , connect , close , domain , onStatus , and allowDomain .

p1,...pN Optional parameters to be passed to the specified method.

Returns
A Boolean value of true if Macromedia Flash MX can carry out the request, false otherwise.

Note: A return value of true does not necessarily mean that Macromedia Flash MX successfully connected to a receiving LocalConnection object, only that the command is syntactically correct. To determine whether the connection succeeded, see LocalConnection.onStatus.

Description
Method; invokes the method named method on a connection opened with the LocalConnection.connect ( connectionName ) command (called the "receiving LC"). The local connection object used with this command is called the "sending LC". The movies that contain the sending and receiving local connection objects must be running on the same client machine.

There is a limit to the amount of data you can pass as parameters to this command. If the command returns false but your syntax is correct, try breaking up the LocalConnection.send requests into multiple commands.

As discussed in LocalConnection.connect, Macromedia Flash MX adds the current subdomain to connectionName by default. If you are implementing communication between different domains, you need to define connectionName in both the sending and receiving local connection objects in such a way that Macromedia Flash MX does not add the current subdomain to connectionName . There are two ways you can do so:

Use an underscore (_) at the beginning of connectionName in both the sending and receiving local connection objects. In the movie containing the receiving local connection object, use LocalConnection.allowDomain to specify that connections from any domain will be accepted. This implementation lets you store your sending and receiving movies in any domain.
Include the subdomain in connectionName in the sending local connection object—for example, myDomain.com:myConnectionName . In the receiving local connection object, use LocalConnection.allowDomain to specify that connections from the specified subdomain will be accepted (in this case, myDomain.com), or that connections from any domain will be accepted.

Note: You cannot specify a subdomain in connectionName in the receiving local connection object, only in the sending local connection object.

Examples
For an example of communicating between local connection objects located in the same domain, see LocalConnection.connect. For an example of communicating between local connection objects located in any domain, see LocalConnection.allowDomain. For an example of communicating between local connection objects located in specified domains, see LocalConnection.allowDomain and LocalConnection.domain.

See also
LocalConnection.allowDomain, LocalConnection.connect, LocalConnection.domain, LocalConnection.onStatus

To Table of Contents Back to Previous document Forward to next document