SHDocVw.IWebBrowser.Navigate

Übergeordnet: IWebBrowser

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 ;

Eigenschaften

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

Beschreibung

Wechselt zu einer über den Pfadnamen oder den URL angegebenen Ressource.

Mit Navigate können Sie eine bestimmte Ressource lokalisieren und herunterladen. Navigate kann eine HTTP-Botschaft zu einem angegebenen URL senden und die Ergebnisse oder einfach die Ergebnisse einer bestimmten Datei anzeigen.

URL gibt den UNC-Pfadnamen einer Datei oder den Uniform Resource Locator einer Internet-Ressource an, die der Webbrowser anzeigen 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 der 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 keinen HTTP-URL enthält.

Headers enthält die Kopfzeilen, die an die Server gesendet werden, wenn der Parameter URL einen HTTP-URL enthält. Mit einem HTTP-Header wird 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: Um zu einer Position zu wechseln, die nicht als URL ausgedrückt werden kann (beispielsweise zu einer Elementbezeichnerliste), verwenden Sie die Methode Navigate2.