Navigate method

  • Article

Note  The Microsoft ActiveX Hyperlink API is deprecated in Windows Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.

 

Navigates to the target hyperlink.

Syntax

HRESULT retVal = object.Navigate(grfHLNF, pbc, pibsc, pihlNavigate);

Parameters

  • grfHLNF [in]
    Type: DWORD

    An unsigned long integer value that specifies the flag that describes how the navigation is to proceed. The value of the flag can be any valid HLNF enumeration value.

  • pbc [in]
    Type: LPBC

    The address of the bind context interface to use for any moniker binding during this operation. This cannot be NULL.

  • pibsc [in]
    Type: IBindStatusCallback

    The address of the IBindStatusCallback object interface to use for any asynchronous moniker binding that is performed during the navigation. If this is NULL, the caller does not receive progress notification, cancellation, pausing, or low-level binding information.

  • pihlNavigate [in]
    Type: IHlink

    The address of the IHlink object interface to the hyperlink target.

Remarks

The MSHTML document calls this method on the host frame when a link is clicked. This is the frame's chance to provide an integrated user interface, cancel the navigation, and so forth. Often the frame simply sets some flags and defers to the IHlink::Navigate method.

See also

Hyperlinks Overview