IBrowser::navigate

Article
08/28/2006

The navigate method is used to navigate to a resource identified by a URL or to the file identified by a full path.

Syntax

HRESULT navigate(
  BSTR bstrURL,
  long dwFlags,
  BSTR bstrTargetFrameName,
  BSTR bstrPostData
);

Parameters

bstrURL
[in] String expression that evaluates to the URL, full path, or Universal Naming Convention (UNC) location and name of the resource to display.
dwFlags
[in] Variable that contains one or more of the NAVIGATEFLAG_ values. For more information, see DTM_NAVIGATE.

bstrTargetFrameName
[in] String that contains the name of the frame in which to display the resource. The possible values for this parameter are described in the following table.

Value	Description
_blank	Load the link into a new unnamed window.
_parent	Load the link into the immediate parent of the document the link is in.
_self	Load the link into the same window the link was clicked in.
_top	Load the link into the full body of the current window.
window name	A named HTML frame.

bstrPostData
[in] Data to send with the HTTP POST transaction. For example, the POST transaction is used to send data gathered by an HTML form.

Return Values

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

S_OK
The method completed successfully.

Remarks

The navigate method resets stylesheet rules applied with the IBrowser3::addStyle method.

Requirements

Pocket PC: Windows Mobile 2002 and later
OS Versions: Windows CE 4.0 and later
Header: webvw.h
Library: webvw.lib

Share via