ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Display programming
monitors, the SWF content expands to fill only one monitor. Flash Player and AIR use a metric to determine which
monitor contains the greatest portion of the SWF, and uses that monitor for full-screen mode. The fullScreenHeight
and fullScreenWidth properties only reflect the size of the monitor that is used for full-screen mode. For more
information, see Stage.fullScreenHeight and Stage.fullScreenWidth in the ActionScript 3.0 Reference for the
Adobe Flash Platform.
Stage scaling behavior for full-screen mode is the same as under normal mode; the scaling is controlled by the Stage
class’s scaleMode property. If the scaleMode property is set to StageScaleMode.NO_SCALE, the Stage’s stageWidth
and stageHeight properties change to reflect the size of the screen area occupied by the SWF (the entire screen, in
this case); if viewed in the browser the HTML parameter for this controls the setting.
You can use the Stage class’s fullScreen event to detect and respond when full-screen mode is turned on or off. For
example, you might want to reposition, add, or remove items from the screen when entering or leaving full-screen
mode, as in this example:
import flash.events.FullScreenEvent;
function fullScreenRedraw(event:FullScreenEvent):void
{
if (event.fullScreen)
{
// Remove input text fields.
// Add a button that closes full-screen mode.
}
else
{
// Re-add input text fields.
// Remove the button that closes full-screen mode.
}
}
mySprite.stage.addEventListener(FullScreenEvent.FULL_SCREEN, fullScreenRedraw);
As this code shows, the event object for the fullScreen event is an instance of the flash.events.FullScreenEvent class,
which includes a fullScreen property indicating whether full-screen mode is enabled (true) or not (false).
Keyboard support in full-screen mode
When Flash Player runs in a browser, all keyboard-related ActionScript, such as keyboard events and text entry in
TextField instances, is disabled in full-screen mode. The exceptions (the keys that are enabled) are:
Selected non-printing keys, specifically the arrow keys, space bar, and tab key
Keyboard shortcuts that terminate full-screen mode: Esc (Windows and Mac), Control-W (Windows), Command-
W (Mac), and Alt-F4
These restrictions are not present for SWF content running in the stand-alone Flash Player or in AIR. AIR supports
an interactive full-screen mode that allows keyboard input.
Mouse support in full-screen mode
By default, mouse events in full-screen mode work the same way as when not in full-screen mode. However, in fullscreen
mode, you can optionally set the Stage.mouseLock property to enable mouse locking. Mouse locking disables
the cursor and enables unbounded mouse movement.
Note: You can only enable mouse locking in full-screen mode for desktop applications. Setting it on applications not in
full-screen mode, or for applications on mobile devices, throws an exception.
Last updated 6/6/2012
169