SHDocVw.TWebBrowserNewWindow2

提供: RAD Studio API Documentation
移動先: 案内検索

C++

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

プロパティ

種類 可視性 ソース ユニット
typedef public SHDocVw.hpp SHDocVw SHDocVw

説明

TWebBrowserNewWindow2 型は,TWebBrowser の OnNewWindow2 イベントハンドラの型です。

Sender は,ターゲットリソースを表示するために新しいウィンドウを必要とする Web ブラウザコントロールです。

ppDisp はオプションで,新しいウィンドウとして動作できる,新たに作成された非表示の TWebBrowser コンポーネントのインターフェースを返します。Web ブラウザはこのコンポーネントを設定して,OnBeforeNavigate2 イベントの発生に続けて,ターゲット URL にジャンプします。イベントハンドラがコンポーネントを作成しないで,そのインターフェースを ppDisp パラメータで返す場合,Web ブラウザは最上位レベルのウィンドウを独立したホストのないプロセスとして生成します。

Cancel は,イベントハンドラが新しいウィンドウの作成をブロックできるようにします。イベントハンドラが Cancel を true に設定すると,OnBeforeNavigate2 イベントの発生に続けて,Web ブラウザはその現在のウィンドウにターゲットリソースを表示しようとします。

メモ:  イベントハンドラは,Cancel を true に設定するときに ppDisp の値を返してはなりません。