SHDocVw.TWebBrowser.Navigate

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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

Eigenschaften

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

Beschreibung

Wechselt zu der durch einen Pfadnamen oder eine URL angegebenen Ressource.

Mit Navigate können Sie eine bestimmte Ressource lokalisieren und herunterladen. Navigate sendet eine HTTP-Botschaft an die angegebene URL und zeigt das Ergebnis an. Sie können mit Navigate aber auch eine bestimmte Datei anzeigen.

URL gibt den UNC-Pfadnamen der Datei oder die URL der Internet-Ressource an, die im Web-Browser angezeigt werden soll.

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.

Anmerkung:  Wenn Sie die Ressource nicht als URL angeben können (z. B. bei einer Elementbezeichnerliste), verwenden Sie stattdessen die Methode Navigate2.

Siehe auch