TextField.addListener()

可用性

Flash Player 6。

用法

my_txt.addListener(listener)

参数

listener一个具有 onChanged 或 onScroller 事件处理函数的对象。

返回

无。

说明

方法；注册一个对象，以便在调用 onChanged 和 onScroller 事件处理函数时接收通知。当文本字段更改或滚动时，首先将调用 TextField.onChanged 和 TextField.onScroller 事件处理函数，然后调用任何注册为侦听器的对象的 onChanged 和 onScroller 事件处理函数。可将多个对象注册为侦听器。

若要从文本字段删除侦听器对象，可以调用 TextField.removeListener()。

事件源将把对该文本字段实例的一个引用作为参数传递给 onScroller 和 onChanged 处理函数。您可以通过将参数放入事件处理函数方法来捕获此数据。例如，以下代码使用 txt 作为传递给 onScroller 事件处理函数的参数。然后，在一条 trace 语句中使用该参数将文本字段的实例名称发送到“输出”面板。

myTextField.onScroller = function (txt) {
  trace (txt._name + " changed");
};

示例

下面的示例为输入文本字段 myText 定义一个 onChange 处理函数。然后定义一个新的侦听器对象，myListener，并为该对象定义一个 onChanged 处理函数。当文本字段 myText 发生更改时，将调用此处理函数。最后一行代码调用 TextField.addListener 向文本字段 myText 注册侦听器对象 myListener，这样，在 myText 更改时将通知该侦听器对象。

myText.onChanged = function (txt) {
  trace (txt._name + " changed");
};
myListener = new Object();
myListener.onChanged = function (txt) {
  trace(txt._name + " changed and notified myListener");
};

myText.addListener(myListener);

另请参见

TextField.onChanged、TextField.onScroller、TextField.removeListener()