User Guide

162 Chapter 5: ActionScript Core Language Elements
The exec command can contain only the characters A–Z, a–z, 0–9, period (.), and underscore
(_). The
exec command runs in the subdirectory fscommand only. In other words, if you use the
fscommand exec command to call an application, the application must reside in a subdirectory
named fscommand.
Usage 2: To use the
fscommand() function to send a message to a scripting language such as
JavaScript in a web browser, you can pass any two parameters in the
command and parameters
parameters. These parameters can be strings or expressions and are used in a JavaScript function
that handles, or catches, the
fscommand() function.
In a web browser, the
fscommand() function calls the JavaScript function
moviename_DoFScommand in the HTML page containing the SWF file. The moviename is the
name of the Flash Player as assigned by the
NAME attribute of the EMBED tag or the ID property of
the
OBJECT tag. If you assign the Flash Player the name myDocument, the JavaScript function
called is
myDocument_DoFScommand.
Usage 3: The
fscommand() function can send messages to Macromedia Director that are
interpreted by Lingo (Director’s scripting language) as strings, events, or executable Lingo code. If
the message is a string or an event, you must write the Lingo code to receive the message from the
fscommand() function and carry out an action in Director. For more information, see the
Director Support Center at www.macromedia.com/support/director.
Usage 4: In Visual Basic, Visual C++, and other programs that can host ActiveX controls, the
fscommand() function sends a VB event with two strings that can be handled in
the environment’s programming language. For more information, use the keywords Flash method
to search the Flash Support Center at www.macromedia.com/support/flash.
Example
In the following example, the fscommand() function sets Flash Player to scale the SWF file to the
full monitor screen size when the
fullscreen_btn button or unfullscreen_btn is released:
this.fullscreen_btn.onRelease = function() {
fscommand("fullscreen", true);
};
this.unfullscreen_btn.onRelease = function() {
fscommand("fullscreen", false);
};