SHDocVw.TWebBrowserBeforeNavigate2

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

TWebBrowserBeforeNavigate2 = procedure(ASender: TObject; const pDisp: IDispatch;
const URL: OleVariant;
const Flags: OleVariant;
const TargetFrameName: OleVariant;
const PostData: OleVariant;
const Headers: OleVariant;
var Cancel: WordBool) of object;

C++

typedef void __fastcall (__closure *TWebBrowserBeforeNavigate2)(System::TObject* ASender, const _di_IDispatch pDisp, const System::OleVariant &URL, const System::OleVariant &Flags, const System::OleVariant &TargetFrameName, const System::OleVariant &PostData, const System::OleVariant &Headers, System::WordBool &Cancel);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
type
typedef
public
SHDocVw.pas
SHDocVw.hpp
SHDocVw SHDocVw

Beschreibung

TWebBrowserBeforeNavigate2 wird für die Behandlungsroutine des Ereignisses BeforeNavigate2 von TWebBrowser verwendet.

Sender gibt den Web-Browser an, der zu einer neuen URL wechseln soll.

pDisp ist die Automatisierungsschnittstelle von Sender.

URL ist die Adresse der Ressource, nach der die Browser-Komponente sucht. Sie können diesen Wert ändern, um die Navigationsoperation zu einer anderen Ressource umzuleiten.

Flags wird aktuell nicht verwendet.

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. Ändern Sie diesen Wert, wenn die Ressource in einem anderen Frame angezeigt werden soll. Eine Liste der möglichen Werte finden Sie in der Beschreibung der Methode Navigate.

PostData enthält die Daten, die an den Server gesendet werden, wenn es sich bei der zugrunde liegenden Operation um eine HTTP-Post-Nachricht handelt. Dieser Wert kann vor dem Senden an die Ziel-URL in der Routine geändert werden.

Headers enthält die Header, die an den Server gesendet werden, wenn die URL einer HTTP-Nachricht entspricht. 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. Dieser Wert kann vor dem Senden an die Ziel-URL in der Routine geändert werden.

Cancel bestimmt, ob der Web-Browser nach dem Beenden der Routine nach der angegebenen Ressource sucht. Wenn Sie Change in true ändern, wird die Operation abgebrochen.