TextField.addListener()

Disponibilidad

Flash Player 6.

Sintaxis

my_txt.addListener(listener)

Parámetros

listener Objeto con un controlador de eventos onChanged o onScroller.

Valor devuelto

Ninguno.

Descripción

Método; registra un objeto para recibir una notificación cuando se invocan los controladores de eventos onChanged y onScroller. Cuando un campo de texto cambia o se desplaza, se invocan los controladores de eventos TextField.onChanged y TextField.onScroller, seguidos por los controladores de eventos onChanged y onScroller de cualquier objeto registrado como detector. Pueden registrarse varios objetos como detectores.

Para eliminar un objeto detector de un campo de texto, llame a TextField.removeListener().

El origen del evento pasa una referencia a la instancia del campo de texto como parámetro para los controladores onScroller y onChanged. Puede capturar estos datos colocando un parámetro en el método del controlador de eventos. Por ejemplo, en el código siguiente se utiliza txt como parámetro que se pasa al controlador de eventos onScroller. A continuación, se utiliza el parámetro en una sentencia trace para enviar el nombre de la instancia del campo de texto al panel Salida.

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

Ejemplo

En el ejemplo siguiente se define un controlador onChange para el campo de introducción de texto myText. A continuación, se define un nuevo objeto detector, myListener, y se define el controlador onChanged para dicho objeto. Este controlador se invocará cuando el campo de texto myText cambie. La línea final del código llama a TextField.addListener para registrar el objeto detector myListener con el campo de texto myText de modo que se le notifique cuando myText cambie.

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);

Véase también

TextField.onChanged, TextField.onScroller, TextField.removeListener()