SHDocVw.TWebBrowserBeforeNavigate2

De RAD Studio API Documentation
Aller à : navigation, rechercher

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

Propriétés

Type Visibilité  Source Unité  Parent
typedef public SHDocVw.hpp SHDocVw SHDocVw

Description

TWebBrowserBeforeNavigate2 est le type du gestionnaire d'événement BeforeNavigate2 sur TWebBrowser.

Sender désigne le contrôle navigateur Web qui va rechercher la nouvelle URL.

pDisp désigne l'interface Automation du contrôle navigateur Web spécifié par Sender.

URL est le localisateur uniforme de ressources que recherche le navigateur Web. Changez cette valeur pour rediriger le déplacement vers une autre ressource.

Flags n'est pas utilisé actuellement.

TargetFrameName est le nom du cadre dans lequel afficher la ressource ou NULL si la ressource ne doit pas être affichée dans un cadre nommé. Modifiez cette valeur pour spécifier où la ressource doit être affichée. Voir la méthode Navigate pour une liste des valeurs possibles.

PostData contient les données envoyées au serveur quand l'opération sous-jacente est un message expédié HTTP. Le gestionnaire d'événement peut modifier cette valeur avant qu'elle ne soit envoyée à l'URL cible.

Headers contient tous les en-têtes envoyés aux serveurs quand l'URL représente un message HTTP. Les en-têtes HTTP spécifient, par exemple, l'action qui est demandée au serveur, le type de données, etc. Voir l'objet TWebRequest dont les propriétés représentent la plupart des en-têtes courants. Le gestionnaire d'événement peut modifier cette valeur avant qu'elle ne soit envoyée à l'URL cible.

Cancel détermine si le navigateur Web recherche la ressource spécifiée après la sortie du gestionnaire d'événement. Affectez true à Cancel pour annuler l'opération de navigation.