User Guide

LocalConnection.connect() 409
LocalConnection.connect()
Availability
Flash Player 6.
Usage
receiving_lc.connect(connectionName:String) : Boolean
Parameters
connectionName
A string that corresponds to the connection name specified in the
LocalConnection.send() command that wants to communicate with receiving_lc.
Returns
A Boolean value: true if no other process running on the same client computer has already issued
this command using the same value for the
connectionName parameter; false otherwise.
Description
Method; prepares a LocalConnection object to receive commands from a
LocalConnection.send() command (called the sending LocalConnection object). The object
used with this command is called the receiving LocalConnection object. The receiving and sending
objects must be running on the same client computer.
Make sure you define the methods attached to
receiving_lc before calling this method, as
shown in all the examples in this section.
By default, Flash Player resolves
connectionName into a value of
"superdomain:connectionName", where superdomain is the superdomain of the SWF file
containing the
LocalConnection.connect() command. For example, if the SWF file
containing the receiving LocalConnection object is located at www.someDomain.com,
connectionName resolves to "someDomain.com:connectionName". (If a SWF file is located on
the client computer, the value assigned to
superdomain is "localhost".)
Also by default, Flash Player lets the receiving LocalConnection object accept commands only
from sending LocalConnection objects whose connection name also resolves into a value of
"superdomain:connectionName". In this way, Flash makes it simple for SWF files located in the
same domain to communicate with each other.
If you are implementing communication only between SWF files in the same domain, specify a
string for
connectionName that does not begin with an underscore (_) and that does not specify a
domain name (for example,
"myDomain:connectionName"). Use the same string in the
LocalConnection.connect(connectionName) command.