Lingo Dictionary > D-F > externalParamValue()

 

externalParamValue()

Syntax

externalParamValue(n)

Description

Function; returns a specific value from the external parameter list in an HTML <EMBED> or <OBJECT> tag. This function is valid only for Shockwave movies that are running in a browser. It can't be used with movies running in the authoring environment or projectors.

If n is an integer, externalParamValue returns the nth parameter value from the external parameter list.

If n is a string, externalParamValue returns the value associated with the first name that matches n. The match isn't case sensitive. If no such parameter value exists, externalParamValue returns VOID.

This function's behavior in an applet differs from that in other Director movies. In an applet, externalParamValue does the following:

Returns the applet's parameters instead of the <EMBED> tag parameters.

Accepts only string parameters.

Returns a zero-length string rather than VOID.

See "Parameters for OBJECT and EMBED tags" and "Parameters accessible from Lingo"in the Director Support Center Web site.

Example

This statement places the value of an external parameter in the variable myVariable:

if externalParamName ("swURLString") = "swURLString" then
	myVariable = externalParamValue ("swURLString")
end if

See also

externalParamCount(), externalParamName()