Microsoft SDK for Java

Navigate2

This method of the WebBrowser class navigates the browser to a location that may not be able to be expressed as a URL, such as a pointer to an item identifier list (PIDL) for an entity in the Microsoft® Windows® shell namespace.

Syntax

public synchronized void Navigate2(com.ms.com.Variant URL,
com.ms.com.Variant Flags, com.ms.com.Variant TargetFrameName,
com.ms.com.Variant PostData, com.ms.com.Variant Headers);

Parameters

URL Required. A string expression that evaluates to the URL, full path, or Universal Naming Convention (UNC) the location and name of the resource to display.
Flags Optional. A value that specifies whether to add the resource to the history list, whether to read from or write to the cache, and whether to display the resource in a new window. It can be a combination of the following values:

navOpenInNewWindow 1

Open the resource or file in a new window.

navNoHistory 2

Do not add the resource or file to the history list. The new page replaces the current page in the list.

navNoReadFromCache 4

Do not read from the disk cache for this navigation.

navNoWriteToCache 8

Do not write the results of this navigation to the disk cache.

TargetFrameName Optional. String expression that evaluates to the name of an HTML frame in the URL to display in the browser window. The possible values for this parameter are:

_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. If no frame or window exists that matches the specified target name, a new window is opened for the specified link. 

PostData Optional. Data to send to the server during the HTTP POST transaction. For example, the POST transaction is used to send data gathered by an HTML form to a program or script. If PostData does not specify any post data, the Navigate2 method issues an HTTP GET transaction. PostData is ignored if the URL is not an HTTP URL.
Headers Optional. A value that specifies additional HTTP headers to send to the server. These headers are added to the default Microsoft® Internet Explorer headers. The headers can specify things like the action required of the server, the type of data being passed to the server, or a status code. Headers is ignored if the URL is not an HTTP URL.

© 1999 Microsoft Corporation. All rights reserved. Terms of use.