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()`