User Guide

778 Chapter 2: ActionScript Language Reference

Stage.addListener()

Availability

Flash Player 6.

Usage

Stage.addListener(myListener:Object) : Void

Parameters

myListener

An object that listens for a callback notification from the Stage.onResize event.

Returns

Nothing.

Description

Method; detects when a SWF file is resized (but only if Stage.scaleMode = "noScale"). The

addListener() method doesn’t work with the default movie clip scaling setting (showAll) or

other scaling settings (

exactFit and noBorder).

To u se

addListener(), you must first create a listener object. Stage listener objects receive

notification from

Stage.onResize.

Example

This example creates a new listener object called stageListener. It then uses myListener to call

onResize and define a function that will be called when onResize is triggered. Finally, the code

adds the

myListener object to the callback list of the Stage object. Listener objects allow multiple

objects to listen for resize notifications.

this.createTextField("stageSize_txt", this.getNextHighestDepth(), 10, 10, 100,

22);

var stageListener:Object = new Object();

stageListener.onResize = function() {

stageSize_txt.text = "w:"+Stage.width+", h:"+Stage.height;

};

Stage.scaleMode = "noScale";

Stage.addListener(stageListener);