SHDocVw.IWebBrowser.Navigate

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

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

C++

virtual HRESULT __safecall Navigate(const System::WideString URL, const System::OleVariant &Flags, const System::OleVariant &TargetFrameName, const System::OleVariant &PostData, const System::OleVariant &Headers) = 0 ;

Properties

Type Visibility Source Unit Parent
procedure
function
public
SHDocVw.pas
SHDocVw.hpp
SHDocVw IWebBrowser

Description

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

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.

See Also