IWebBrowser.Navigate Method

Navigates to a resource identified by a path name or URL.

Pascal

procedure Navigate(const URL: WideString; const Flags: OleVariant; const TargetFrameName: OleVariant; var PostData: OleVariant; const Headers: OleVariant); safecall;

C++

__fastcall Navigate(const BSTR URL, const OleVariant Flags, const OleVariant TargetFrameName, OleVariant PostData, const OleVariant Headers);

Description

Use Navigate to locate and download a specific resource. Navigate can send an HTTP message to a specified URL and display the results or simply display the results of a specified file.

URL specifies the UNC path name of a file or the Uniform Resource Locator of an Internet resource that the Web browser should display.

Flags is a set of values that specify whether to add the resource to the history list, to read from or write to the cache, or to display the resource in a new window. It can be a sum of zero or more of the following.

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.
navAllowAutosearch	16	If the navigation fails, the Web browser attempts to navigate common root domains (.com, .edu, and so on). If this still fails, the URL is passed to a search engine.

TargetFrameName is the name of the frame in which the resource will be displayed, or NULL if the resource should not be displayed in a named frame.

PostData contains the data sent to the server when using Navigate to generate an HTTP POST message. If PostData is NULL, Navigate generates an HTTP GET message. PostData is ignored if URL does not specify an HTTP URL.

Headers contains any headers sent to the servers when the URL represents an HTTP URL. HTTP headers specify the intended action required of the server, the type of data, and so on. (See TWebRequest object, whose properties represent many of the more common headers).

Note: To navigate to a location that cannot be expressed as an URL (for example, to an item identifier list), use the Navigate2 method instead.