Contents
Previous Topic: GoSearch Method
Next Topic: Navigate2 Method
| | |
| ||
| ||
Navigate Method
Description
Navigates to the resource identified by a Universal Resource Locator (URL) or to the file identified by a full path.
Syntax
object.Navigate URL [Flags,] [TargetFrameName,] [PostData,] [Headers]
Part Description object Required. An object expression that evaluates to an object in the Applies To list. URL Required. A string expression that evaluates to the URL, full path, or Universal Naming Convention (UNC) location and name of the resource to display. Flags Optional. 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. TargetFrameName Optional. 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. 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 this parameter does not specify any post data, the Navigate method issues an HTTP GET transaction. This parameter is ignored if 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 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.
Remarks
The WebBrowser control or InternetExplorer object can browse to any location in the local file system, on the network, or on the World Wide Web. Use the Navigate method to tell the browser which location to browse to. By including a text box in your application, you can let the user specify the location to browse to and then pass the location to the Navigate method.
Applies To
See Also
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.