SHDocVw.TWebBrowserNewWindow2

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

TWebBrowserNewWindow2 = procedure(ASender: TObject; var ppDisp: IDispatch; var Cancel: WordBool) of object;

C++

typedef void __fastcall (__closure *TWebBrowserNewWindow2)(System::TObject* ASender, _di_IDispatch &ppDisp, System::WordBool &Cancel);

Propriétés

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

Description

TWebBrowserNewWindow2 est le type du gestionnaire d'événement OnNewWindow2 sur TWebBrowser.

Sender est le navigateur Web qui a besoin d'une nouvelle fenêtre pour afficher la ressource cible.

ppDisp renvoie, de manière optionnelle, l'interface du nouveau composant TWebBrowser créé caché qui sert de nouvelle fenêtre. Le composant navigateur Web configure ce composant et atteint l'URL cible en démarrant avec un événement OnBeforeNavigate2. Si le gestionnaire d'événement ne crée pas un composant et renvoie son interface comme paramètre ppDisp, le navigateur Web génère une fenêtre de niveau supérieur comme processus séparé non hébergé.

Cancel permet au gestionnaire d'événement de bloquer la création d'une nouvelle fenêtre. Quand le gestionnaire d'événement initialise Cancel à true, le navigateur Web tente d'afficher le ressource cible dans sa propre fenêtre et commence par un événement OnBeforeNavigate2.

Remarque :  Le gestionnaire d'événement ne doit pas renvoyer de valeur pour ppDisp quand Cancel est initialisé à true.