ActionScript for Flash MX: The Definitive Guide, Second Edition

TextField.removeTextField() Method

This is the Title of the Book, eMatter Edition

Copyright © 2007 O’Reilly & Associates, Inc. All rights reserved.

Alphabetical Language Reference

|

859

Description

The removeListener() method stops listener from receiving notification of onScroller() and

onChanged() events occurring on

theField. It should be used only after listener has been

registered as an event listener via addListener(). The

listener object is not deleted, but it

can be removed and added repeatedly. Event listeners normally are removed when the task

they perform is no longer required. For example, a listener that controls a scrollbar could

be removed when an application enters a disabled state due to, say, the launching of a

modal dialog box.

Example

// Make a text field that accepts user input.

this.createTextField("theField_txt", 1, 0, 0, 200, 20);

theField_txt.border = true;

theField_txt.type = "input";

// Create a listener.

txtListener = new Object();

// Add the onScroller function to the listener.

txtListener.onScroller = function (tfObject) {

trace(tfObject + " scroll property changed.");

}

// This adds the listener to theField_txt.

theField_txt.addListener(txtListener);

// This removes the listener from theField_txt.

theField_txt.removeListener(txtListener);

// This also removes the listener from theField_txt, but it

// displays an error message if the listener is not found.

if (!theField_txt.removeListener(txtListener)) ...