MACROMEDIA FLASH 8-FLASH, Reference

Page: 124 / 162

124 Flash Lite Specific Language Elements
fscommand2()
Availability
Flash Lite 1.1.
Usage
returnValue = fscommand2( command [, expression1 ... expressionN ])
Parameters
command
A string passed to the host application for any use or a command passed to
Flash Lite.
parameter1...parameterN
A comma-delimited list of strings passed as parameters to the
command specified by
command
.
Description
Function; allows the SWF file to communicate with either Flash Lite or the host
environment, such as the phone or device’s operating system. The value that
fscommand2()
returns depends on the specific command.
The
fscommand2()
function is similar to the
fscommand()
function, with the following
differences:
■
The
fscommand2()
function can take an arbitrary number of arguments.
■
Flash Lite executes
fscommand2()
immediately, whereas
fscommand()
is executed at the
end of the frame being processed.
■
The
fscommand2()
function returns a value that can be used to report success, failure, or
the result of the command.
The strings and expressions that you pass to the function as commands and parameters are
described in the tables in this section.
The tables have the following three columns:
■
The Command column shows the string literal parameter that identifies the command.
■
The Parameters column explains what kinds of values to pass for the additional
parameters, if any.
■
The Value returned column explains the expected return values.