User Guide

782 Chapter 2: ActionScript Language Reference
Stage.removeListener()
Availability
Flash Player 6.
Usage
Stage.removeListener(myListener:Object) : Boolean
Parameters
myListener
An object added to an object’s callback list with addListener().
Returns
A Boolean value.
Description
Method; removes a listener object created with addListener().
Example
The following example displays the Stage dimensions in a dynamically created text field. When
you resize the Stage, the values in the text field update. Create a button with an instance name
remove_btn. Add the following ActionScript to Frame 1 of the Timeline.
this.createTextField("stageSize_txt", this.getNextHighestDepth(), 10, 10, 100,
22);
stageSize_txt.autoSize = true;
stageSize_txt.border = true;
var stageListener:Object = new Object();
stageListener.onResize = function() {
stageSize_txt.text = "w:"+Stage.width+", h:"+Stage.height;
};
Stage.addListener(stageListener);
remove_btn.onRelease = function() {
stageSize_txt.text = "Removing Stage listener...";
Stage.removeListener(stageListener);
}
Select Control > Test Movie to test this example. The values you see in the text field are updated
when you resize the testing environment. When you click
remove_btn, the listener is removed
and the values are no longer updated in the text field.
See also
Stage.addListener()