User Guide

Stage 623

removeListener (Stage.removeListener method)

public static removeListener(listener:Object) : Boolean

Removes a listener object created with addListener().

Availability: ActionScript 1.0; Flash Lite 2.0

Parameters

listener:Object - An object added to an object's callback list with addListener().

Returns

Boolean - A Boolean value.

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.