ActionScript API

There are new ActionScript methods in ActionScript 2.0 andActionScript 3.0 to initiate or leave full-screen mode, andcorresponding events to notify the movie when full-screen mode beginsor ends. As previously mentioned, the ActionScript to initiatefull-screen mode works only in reaction to a mouse click or keypress

ActionScript 2.0

Stage.displayState:String property

This property is gettable and settable.Possible values are:

• fullScreen
• normal

This property is used to check the current state of the movie or to enter or exit full-screen mode.

An event listener on the Stage object provides notification when the movie enters or leaves full-screen mode:

EventListener.onFullScreen = function( bFull:Boolean ){}


Stage.addListener( EventListener );

This method is called when the movie enters or leaves full-screenmode. The Boolean argument to this function indicates whether the moviehas entered (true) or exited (false) full-screen mode.

ActionScript 3.0

flash.display.Stage.displayState:String property

This property is gettable and settable. The valid values are from the class StageDisplayState:

This property is used to check the current state of the movie or to enter or exit full-screen mode.

An event listener on the Stage object provides notification when the movie enters or leaves full-screen mode:

fullScreenHandler = function( event:FullScreenEvent ) {}; 


stage.addEventListener( FullScreenEvent.FULL_SCREEN, fullScreenHandler ); 

The AS3 event received is FullScreenEvent, which extends ActivityEvent. FullScreenEvent has a Boolean fullScreen property, which indicates whether the movie has entered (true) or exited (false) full-screen mode.

ActionScript 3.0 will throw a security error in the plug-in or ActiveX control if the display state is set to StageDisplayState.FULL_SCREEN when it is not permitted by one of the security restrictions listed above.