invokeLoc Function

Switches to a new location.

Syntax

invokeLoc('location'.split(','));

Parameters

location: The location to switch to.

Returns

There is no return value.

Remarks

The invokeLoc function can be called from within the HTML element of a location of type "HTML", or from within the SCRIPT element of a custom location type.

Example 1

TQS will switch to location 1,3.

<CUSTOMDIV NAME="CUSTOM_FOO">
  ...
  <SCRIPT>
    ...
    invokeLoc('1,3'.split(','));
    ...
  </SCRIPT>
</CUSTOMDIV>

Example 2

This sample creates a link which will switch to location 1,1.

<LOC ID="1,0" TYPE="HTML">
  <HTML>
    ...
    <a onclick="event.returnValue=false;
      invokeLoc('1,1'.split(','));" href="">...</a>
    ...
  </HTML>
</LOC>