User Guide

466 Flash Player Security

To enable full-screen mode, in the <object> and <embed> tags in the HTML page that

contains a reference to the SWF file, add the

allowFullScreen parameter, with its value set

"true" (the default value is "false"), as shown in the following example:

codebase="http://fpdownload.macromedia.com/pub/shockwave/cabs/flash/

swflash.cab#version=9,0,18,0"

width="600" height="400" id="test" align="middle">

width="600" height="400"

name="test" align="middle" type="application/x-shockwave-flash"

pluginspage="http://www.macromedia.com/go/getflashplayer" />

</object>

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 and Flex 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.

Users cannot enter text in text input fields while in full-screen mode. All keyboard input and

keyboard-related ActionScript is disabled while in full-screen mode, with the exception of the

keyboard shortcuts (such as pressing the Esc key) that return the application to normal mode.

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.

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 472.

Administrators can disable full-screen mode for SWF files running in browsers by setting

FullScreenDisable = 1 in the mms.cfg file. For details, see “Administrative user controls”

on page 452.

In a browser, a SWF file must be contained in an HTML page to allow full-screen mode.

Full-screen mode is always permitted in the stand-alone player or in a projector file.