navigateTarget

See Also      Tasks      Applies To

Specifies a target, such as a frame, for navigation. Available in client script only.

Syntax

object.navigateTarget

Parameters

object

A PageObject object.

Remarks

The navigateTarget property affects the functionality of the navigate methods. The navigate methods are the navigateURL method and published methods on the navigate script object.

This property makes it easier to use the Microsoft® Visual InterDev™ scripting object model with framesets by making it possible to force the navigation to a different frame.

The default value of navigateTarget is the window object, which causes navigation to update the current frame. However, navigateTarget can be set to a different frame so that the page to which you are navigating is forced to appear in that frame.

Note   Any window object may be assigned to navigateTarget. This includes the return value from the window.open() function.

Example

<SCRIPT LANGUAGE=JAVASCRIPT>
thisPage.navigateTarget = parent.frames.MyFrame;
MyPage.navigate.MyMethod();
</SCRIPT>

The script above calls MyMethod on MyPage and displays the resulting page in MyFrame. The navigateTarget property is primarily useful when building a frameset that has a navigation bar in a separate frame from the content. The navigation buttons can have code like the example above to control what shows up in the content frame.