SHDocVw.TWebBrowserNewWindow2
C++
typedef void __fastcall (__closure *TWebBrowserNewWindow2)(System::TObject* ASender, _di_IDispatch &ppDisp, System::WordBool &Cancel);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| typedef | public | SHDocVw.hpp | SHDocVw | SHDocVw |
Beschreibung
TWebBrowserNewWindow2 wird für die Behandlungsroutine des Ereignisses OnNewWindow2 von TWebBrowser verwendet.
Sender gibt die Browser-Komponente an, die ein neues Fenster für die Zielressource benötigt.
ppDisp gibt optional die Schnittstelle einer neu erstellten, verborgenen TWebBrowser-Komponente zurück, die als neues Fenster dienen kann. Der Web-Browser konfiguriert diese Komponente und wechselt zur Ziel-URL. Zuvor wird das Ereignis OnBeforeNavigate2 ausgelöst. Wenn in der Behandlungsroutine keine Komponente erstellt und deren Schnittstelle im Parameter ppDisp zurückgegeben wird, erzeugt der Browser ein Fenster oberster Ebene als eigenen Prozess.
Cancel ermöglicht der Ereignisbehandlungsroutine, das Erstellen eines neuen Fensters zu verhindern. Wenn Cancel auf true gesetzt wird, versucht der Web-Browser, die Zielressource im aktuellen Fenster anzuzeigen.
Anmerkung: Wenn in der Routine Cancel auf true gesetzt wird, sollte kein Wert in ppDisp zurückgegeben werden.