Flash Player 3.
fscommand("command","parameters")
command A string passed to the host application for any use, or a command passed to Flash Player.
parameters A string passed to the host application for any use, or a value passed to Flash Player.
Nothing.
Function; lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. You can also use the fscommand() function to pass messages to Macromedia Director, or to Visual Basic, Visual C++, and other programs that can host ActiveX controls.
Usage 1: To send a message to Flash Player, you must use predefined commands and parameters. The following table shows the values you can specify for the command and parameters parameters of the fscommand() function to control a SWF file playing in Flash Player, including projectors.
| Command | Parameters | Purpose |
|---|---|---|
quit |
None |
Closes the projector. |
fullscreen |
|
Specifying |
allowscale |
|
Specifying |
showmenu |
|
Specifying |
exec |
|
Executes an application from within the projector. |
trapallkeys |
|
Specifying |
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.
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);
};
The following example uses the fscommand() function applied to a button in Flash to open a JavaScript message box in an HTML page. The message itself is sent to JavaScript as the fscommand parameter.
You must add a function to the HTML page that contains the SWF file. This function, myDocument_DoFSCommand, sits in the HTML page and waits for an fscommand() function in Flash. When an fscommand is triggered in Flash (for example, when a user presses the button), the command and parameter strings are passed to the myDocument_DoFSCommand function. You can use the passed strings in your JavaScript or VBScript code in any way you like. In this example, the function contains a conditional if statement that checks to see if the command string is "messagebox". If it is, a JavaScript alert box (or "message box") opens and displays the contents of the parameters string.
function myDocument_DoFSCommand(command, args) {
if (command == "messagebox") {
alert(args);
}
}
In the Flash document, add the fscommand() function to a button:
fscommand("messagebox", "This is a message box called from within Flash.")
You can also use expressions for the fscommand() function and parameters, as in the following example:
fscommand("messagebox", "Hello, " + name + ", welcome to our website!")
To test the SWF file, select File > Publish Preview > HTML.
Note: If you publish your SWF file using the Flash with FSCommand template in the HTML tab of the Publish Settings dialog box, the myDocument_DoFSCommand function is inserted automatically. The SWF file's NAME and ID attributes will be the filename. For example, for the file myDocument.fla, the attributes would be set to myDocument.
RSS feed | Send me an e-mail when comments are added to this page | Comment Report
Current page: http://livedocs.adobe.com/flash/mx2004/main_7_2/00001352.html
Comments
recoveredfromflashMX2004 said on Aug 4, 2004 at 2:40 PM : sandhanagopal said on Aug 25, 2004 at 4:20 AM :