SHDocVw.TWebBrowserBeforeNavigate2

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

Delphi

TWebBrowserBeforeNavigate2 = procedure(ASender: TObject; const pDisp: IDispatch;
const URL: OleVariant;
const Flags: OleVariant;
const TargetFrameName: OleVariant;
const PostData: OleVariant;
const Headers: OleVariant;
var Cancel: WordBool) of object;

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

プロパティ

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

説明

TWebBrowserBeforeNavigate2 型は,TWebBrowser の BeforeNavigate2 イベントハンドラの型です。

Sender は,新しい URL を参照しようとしている Web ブラウザコントロールです。

pDisp は,Sender の指定する Web ブラウザコントロールの Automation インターフェースです。

URL は,Web ブラウザが参照中のリソースの Uniform Resource Locator です。この値を変更すると,ナビゲーション処理を別のリソースにリダイレクトできます。

Flags は,現在使用されていません。

TargetFrameName は,リソースを表示するフレームの名前です。ただし,リソースを名前付きフレームに表示してはいけない場合には NULL です。この値を変更すると,リソースの表示先を変更できます。指定できる値のリストについては,Navigate メソッドを参照してください。

PostData は,基底処理が HTTP ポストメッセージのときにサーバーに送られるデータを保持します。イベントハンドラは,ターゲット URL に送られる前にこの値を変更できます。

Headers は,URL が HTTP メッセージを表すときにサーバーに送られるヘッダーを保持します。HTTP ヘッダーは,サーバーの必要とする意図的なアクション,データの型などの要素を指定します(TWebRequest オブジェクトを参照してください。TWebRequest のプロパティでは,もっと一般的なさまざまなヘッダーを指定します)。イベントハンドラは,ターゲット URL に送られる前にこの値を変更できます。

Cancel は,イベントハンドラが生じた後に Web ブラウザが指定されたリソースを参照するかどうかを指定します。Cancel を true に設定すると,ジャンプ操作を無効にすることができます。