SHDocVw.TWebBrowser.Navigate
Delphi
procedure Navigate(const URL: WideString); overload;
procedure Navigate(const URL: WideString; const Flags: OleVariant); overload;
procedure Navigate(const URL: WideString; const Flags: OleVariant; const TargetFrameName: OleVariant); overload;
procedure Navigate(const URL: WideString; const Flags: OleVariant; const TargetFrameName: OleVariant; const PostData: OleVariant); overload;
procedure Navigate(const URL: WideString; const Flags: OleVariant; const TargetFrameName: OleVariant; const PostData: OleVariant; const Headers: OleVariant); overload;
C++
void __fastcall Navigate(const System::WideString URL)/* overload */;
void __fastcall Navigate(const System::WideString URL, const System::OleVariant &Flags)/* overload */;
void __fastcall Navigate(const System::WideString URL, const System::OleVariant &Flags, const System::OleVariant &TargetFrameName)/* overload */;
void __fastcall Navigate(const System::WideString URL, const System::OleVariant &Flags, const System::OleVariant &TargetFrameName, const System::OleVariant &PostData)/* overload */;
void __fastcall Navigate(const System::WideString URL, const System::OleVariant &Flags, const System::OleVariant &TargetFrameName, const System::OleVariant &PostData, const System::OleVariant &Headers)/* overload */;
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
procedure function |
public | SHDocVw.pas SHDocVw.hpp |
SHDocVw | TWebBrowser |
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, whether to read from or write to the cache, and whether 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 such things as 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 can't be expressed as an URL (for example, to an item identifier list), use the Navigate2 method instead.