MACROMEDIA DIRECTOR MX 2004-DIRECTOR SCRIPTING Reference page 304

externalEvent()
Usage
externalEvent "string"
Description
Command; sends a string to the browser that the browser can interpret as a scripting language
instruction, allowing a movie playing or a browser to communicate with the HTML page in
which it is embedded.
This command works only for movies in browsers.
Note: The
externalEvent
determine whether the browser handled the event or ignored it. Use
browser to return a message to the movie.
Parameters
Required. The string to send to the browser. This string must be in a scripting language
string
supported by the browser.
Example
The following statements use
is supported by Netscape 3.x and later.
LiveConnect evaluates the string passed by
must define and name this function in the HTML header. In the movie, the function name and
parameters are defined as a string in
by the browser as separate strings, each parameter is surrounded by single quotation marks.
Statements within HTML:
function MyFunction(parm1, parm2) {
//script here
}
Statements within a script in the movie:
externalEvent ("MyFunction('parm1','parm2')")
The following statements use
Internet Explorer in Windows. ActiveX treats
event and its string parameter the same as an
•
Statements within HTML:
In the HTML header, define a function to catch the event; this example is in VBScript:
Sub
NameOfShockwaveInstance_externalEvent(aParam)
'script here
End Sub
304 Chapter 12: Methods
command does not produce a return value. There is no immediate way to
in the LiveConnect scripting environment, which
externalEvent
externalEvent
externalEvent
in the ActiveX scripting environment used by
externalEvent
externalEvent
onClick
on EvalScript
as a function call. JavaScript authors
. Because the parameters must be interpreted
as an event and processes this
event in a button object.
within the