Nav Trigger

[This is preliminary documentation and subject to change.]

Nav triggers cause the enhancement control to display the specified page.

"2 <location>[[targ: targetName]]"

where

location
Specifies the location of the enhancement page to be displayed. This location can be either a fully-specified Broadcast Architecture URL, or a location relative to the enhancement's base page.

If you are displaying a new enhancement base page, you should use a fully-specified Broadcast Architecture URL. This is because the new base typically will be located in a directory that is not a subdirectory of the old page. In other words, you typically cannot specify a relative path to a new base page.

targetName
An optional parameter that specifies the name of the target element in which to display the new content. The target element can be a set of <FRAME>, <IFRAME>, <SPAN>, or <DIV> tags.

If targetName is not specified, the enhancement control navigates the highest-level window of the Web browser to the specified URL. (This functionality produces the same result as setting TARGET="_top" in an HREF link.)

Remarks

Broadcast Architecture also supports the following alternative formats for Nav triggers:

"3 <location>[[targ:targetName]]"

where all parameters are the same as described preceding, but the key value is three. This format has been kept for compatibility with earlier versions of Broadcast Architecture.

"2 [&targetName&]location"

where all parameters are the same as described preceding. This is the ASF format used by Microsoft® NetShow™ server.

Using a Nav trigger, you can sequence complex interactive Web content without any scripting.

The Enhancement control's response to this trigger depends on the state of the Enhancement control's TargetSync property. When this property is set to False, the control does not navigate immediately to the specified URL but does save the URL. When this property is once again set to True, the control navigates to the URL most recently specified.

Examples

The following are examples of valid Nav triggers.

"2 <MyEnh.htm>[targ:Left]"
"2 <bpc://msnbc/myshow/file.htm>"
"2 MyDir\MyEnh.htm"
"2 &Left&MyDir\MyEnh.htm"
 

See Also

EnhEvent.PageName, EnhEvent.TargName