LocalConnection.onStatus

可用性

Flash Player 6。

用法

sending_lc.onStatus = function(infoObject) {
  // 此处是您的语句
}

参数

infoObject 按照状态消息定义的参数。有关此参数的详细信息,请参见下面的“说明”。

返回

无。

说明

事件处理函数;在发送方 LocalConnection 对象尝试向接收方 LocalConnection 对象发送命令之后调用。如果要对此事件处理函数做出响应,则必须创建一个函数来处理
LocalConnection 对象所发送的信息对象。

如果此事件处理函数返回的信息对象包含 "Status"level 值,则表明 Flash 已将该命令成功发送到接收方 LocalConnection 对象。这并不意味着 Flash 已成功调用接收方
LocalConnection 对象的指定方法,而只表示 Flash 能够发送该命令。例如,如果接收方 LocalConnection 对象不允许从发送方域建立连接,或者该方法不存在,则不调用该方法。确知是否已调用该方法的唯一方式是让接收方对象向发送方对象发送应答。

如果此事件处理函数返回的信息对象包含 "Error"level 值,则表明 Flash 无法将该命令发送到接收方 LocalConnection 对象,这很可能是因为未连接这样的接收方 LocalConnection 对象:其名称对应于调用此处理函数的 sending_lc.send() 命令中所指定的名称。

除了此 onStatus 处理函数外,Flash 还提供称作 System.onStatus 的“超级”函数。如果为特定对象调用了 onStatus 但未分配任何函数对其进行响应,则 Flash 将处理分配到
System.onStatus 的函数(如果存在)。

大多数情况下,实现此处理函数只是为了对错误条件做出响应,如以下示例所示。

示例

以下示例显示关于“输出”面板中的失败连接的信息:

sending_lc = new LocalConnection();
sending_lc.onStatus = function(infoObject)
{
  if (infoObject.level == "Error")
  {
    trace("Connection failed.");
  }
}
sending_lc.send("receiving_lc", "methodName");

另请参见

LocalConnection.send()System.onStatus