Navigate2 MethodNavigate2 Method*
*



Contents  *



Index  *Topic Contents
*Previous Topic: Navigate Method
*Next Topic: PutProperty Method

Navigate2 Method

Description

Navigates to the resource identified by a Universal Resource Locator (URL) or to the file identified by a full path. The Navigate2 method extends the Navigate method to support browsing on special folders—such as Desktop and My Computer—that are represented by a pointer to an item identifier list (PIDL). However, this is not applicable to the Visual Basic programming language. For information on this functionality, see the Using the WebBrowser Control from C/C++ section.

Syntax

object.Navigate2 URL [Flags,] [TargetFrameName,] [PostData,] [Headers]

PartDescription
objectRequired. An object expression that evaluates to an object in the Applies To list.
URLRequired. A string expression that evaluates to the URL of the resource to display or the full path to the file location.
FlagsOptional. A constant or 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 constants or values.
Constant Value Meaning
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.
TargetFrameNameOptional. String expression that evaluates to the name of an HTML frame in 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.
PostDataOptional. 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 this parameter does not specify any post data, the Navigate2 method issues an HTTP GET transaction. This parameter is ignored if URL is not an HTTP URL.
HeadersOptional. A value that specifies additional HTTP headers to send to the server. These headers are added to the default 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. This parameter is ignored if URL is not an HTTP URL.

Applies To

InternetExplorer, WebBrowser

See Also

Navigate


Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.