SHDocVw.TWebBrowser.Navigate2

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure Navigate2(const URL: OleVariant); overload;
procedure Navigate2(const URL: OleVariant; const Flags: OleVariant); overload;
procedure Navigate2(const URL: OleVariant; const Flags: OleVariant;
const TargetFrameName: OleVariant); overload;
procedure Navigate2(const URL: OleVariant; const Flags: OleVariant;
const TargetFrameName: OleVariant; const PostData: OleVariant); overload;
procedure Navigate2(const URL: OleVariant; const Flags: OleVariant;
const TargetFrameName: OleVariant; const PostData: OleVariant;
const Headers: OleVariant); overload;

C++

void __fastcall Navigate2(const System::OleVariant &URL)/* overload */;
void __fastcall Navigate2(const System::OleVariant &URL, const System::OleVariant &Flags)/* overload */;
void __fastcall Navigate2(const System::OleVariant &URL, const System::OleVariant &Flags, const System::OleVariant &TargetFrameName)/* overload */;
void __fastcall Navigate2(const System::OleVariant &URL, const System::OleVariant &Flags, const System::OleVariant &TargetFrameName, const System::OleVariant &PostData)/* overload */;
void __fastcall Navigate2(const System::OleVariant &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 specified resource.

Use Navigate2 to locate and download a specific resource. Navigate can send an HTTP message to a specified URL and display the results, display the results of a specified file, or navigate to a resource that can't be expressed as an URL such as an item identifier list.

URL specifies the UNC path name of a file, the Uniform Resource Locator of an Internet resource, or a pointer to an item identifier list (PIDL).

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).

See Also