ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Security
To enable full-screen mode, in the and tags in the HTML page that contains a reference to the SWF
file, add the allowFullScreen parameter, with its value set to "true" (the default value is "false"), as shown in the
following example:
An HTML page may also use a script to generate SWF-embedding tags. You must alter the script so that it inserts the
proper allowFullScreen settings. HTML pages generated by Flash Professional and Flash Builder use the
AC_FL_RunContent() function to embed references to SWF files, and you need to add the allowFullScreen
parameter settings, as in the following:
AC_FL_RunContent( ... "allowFullScreen", "true", ...)
The ActionScript that initiates full-screen mode can be called only in response to a mouse event or keyboard event. If
it is called in other situations, Flash Player throws an exception.
A message appears when the content enters full-screen mode, instructing the user how to exit and return to normal
mode. The message appears for a few seconds and then fades out.
For content that is running in a browser, keyboard usage is restricted in full-screen mode. In Flash Player 9, only
keyboard shortcuts that return the application to normal mode, such as pressing the Escape key, are supported. Users
can’t enter text in text fields or navigate around the screen. In Flash Player 10 and later, certain non-printing keys
(specifically the arrow keys, space, and Tab key) are supported. However, text input is still prohibited.
Full-screen mode is always permitted in the stand-alone player or in a projector file. Also, keyboard usage (including
text input) is fully supported in those environments.
Calling the displayState property of a Stage object throws an exception for any caller that is not in the same security
sandbox as the Stage owner (the main SWF file). For more information, see “Stage security” on page 1052.
Administrators can disable full-screen mode for SWF files running in browsers by setting FullScreenDisable = 1
in the mms.cfg file. For details, see “Administrator controls” on page 1037.
In a browser, a SWF file must be contained in an HTML page to allow full-screen mode.
Full-screen interactive mode security
Flash Player 11.3 and later, Adobe AIR 1.0 and later
Flash Player 11.3 and later support full-screen interactive mode, in which content running in Flash Player can fill the
entire screen and accept text input. To enter full-screen interactive mode, the displayState property of the Stage is
set to the StageDisplayState.FULL_SCREEN_INTERACTIVE constant. For more information, see “Working with
full-screen mode” on page 167.
Last updated 6/6/2012
1047