SHDocVw.TWebBrowserNewWindow2
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.