SHDocVw.TWebBrowser.Navigate2

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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 */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
SHDocVw.pas
SHDocVw.hpp
SHDocVw TWebBrowser

Beschreibung

Wechselt zu einer bestimmten Ressource.

Mit Navigate2 können Sie eine bestimmte Ressource lokalisieren und herunterladen. Die Methode sendet eine HTTP-Botschaft an die angegebene URL und zeigt das Ergebnis an. Sie kann aber auch einfach eine bestimmte Datei anzeigen oder zu einer Ressource wechseln, die nicht als URL angegeben werden kann (z. B. eine Elementbezeichnerliste).

URL gibt den UNC-Pfadnamen einer Datei, die URL einer Internet-Ressource oder einen Zeiger auf eine Elementbezeichnerliste (PIDL) an.

Flags besteht aus einer Menge von Werten, die angeben, ob die Ressource in die Verlaufsliste aufgenommen, in einem neuen Fenster angezeigt oder aus dem Cache gelesen bzw. in ihn geschrieben wird. Sie können keinen, einen oder mehrere der folgenden Werte angeben:



Konstante Wert Bedeutung

navOpenInNewWindow

1

Die Ressource oder Datei wird in einem neuen Fenster geöffnet.

navNoHistory

2

Die Ressource oder Datei wird nicht in die Verlaufsliste aufgenommen. Die aktuelle Seite in der Liste wird durch die neue Seite ersetzt.

navNoReadFromCache

4

Die Ressource oder Datei wird nicht aus dem Cache gelesen.

navNoWriteToCache

8

Die Ressource oder Datei wird nicht in den Cache geschrieben.

navAllowAutosearch

16

Wenn die Navigation fehlschlägt, verwendet der Browser die bekannten Top-Level-Domänen (.com, .edu usw.). Kann die Ressource immer noch nicht gefunden werden, wird die URL an eine Suchmaschine übergeben.



TargetFrameName gibt den Frame an, in dem die Ressource angezeigt wird. Der Wert NULL wird übergeben, wenn die Ressource nicht in einem benannten Frame angezeigt werden soll.

PostData enthält die Daten, die bei einer HTTP-Post-Botschaft an den Server gesendet werden. Hat der Parameter den Wert NULL, generiert Navigate eine HTTP-GET-Botschaft. PostData wird ignoriert, wenn der Parameter URL keine HTTP-URL enthält.

Headers enthält die Kopfzeilen, die an die Server gesendet werden, wenn der Parameter URL eine HTTP-URL enthält. Mit einem HTTP-Header wird beispielsweise die gewünschte Aktion, der Datentyp usw. angegeben. Weitere Informationen hierzu finden Sie bei der Beschreibung des Objekts TWebRequest, dessen Eigenschaften den meist verwendeten Headern entsprechen.

Siehe auch