NavigateTo Method

  • Article

Navigates in an Active Document container to a specified location.

Object.NavigateTo(cTarget [, cLocation [, cFrame]])

Parameters

  • cTarget
    Specifies the URL to navigate to. cTarget can be a URL or a document supported by the Active Document container such as Microsoft Internet Explorer. The NavigateTo method isn't executed if cTarget is not supported by the Active Document container.
  • cLocation
    Specifies a location to navigate to within the URL or document specified with cTarget.
  • cFrame
    Specifies a frame to navigate to within the URL or document specified with cTarget.

Remarks

If the NavigateTo method is executed in a hosted Visual FoxPro Active Document, the Active Document host navigates to the specified location.

If the NavigateTo method is executed outside of a hosted Visual FoxPro Active Document, then the application that is registered as supporting Active Documents (such as Microsoft Internet Explorer) is started. For example, if you execute the NavigateTo method from the Command window or a Visual FoxPro program (.prg), your registered Active Document container is started and it navigates to the specified location.

Note that a new instance of your registered Active Document container is started each time you execute the NavigateTo method outside of a hosted Visual FoxPro Active Document. Use the Hyperlink Button Foundation Class to navigate to a URL from a Visual FoxPro application without starting a new instance of your registered Active Document container.

See Also

GoBack Method | GoFoward Method

Applies To: Hyperlink Object