SHDocVw.TWebBrowser.Navigate

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

Delphi

procedure Navigate(const URL: WideString); overload;
procedure Navigate(const URL: WideString; const Flags: OleVariant); overload;
procedure Navigate(const URL: WideString; const Flags: OleVariant;  const TargetFrameName: OleVariant); overload;
procedure Navigate(const URL: WideString; const Flags: OleVariant;  const TargetFrameName: OleVariant; const PostData: OleVariant); overload;
procedure Navigate(const URL: WideString; const Flags: OleVariant;  const TargetFrameName: OleVariant; const PostData: OleVariant; const Headers: OleVariant); overload;

C++

void __fastcall Navigate(const System::WideString URL)/* overload */;
void __fastcall Navigate(const System::WideString URL, const System::OleVariant &Flags)/* overload */;
void __fastcall Navigate(const System::WideString URL, const System::OleVariant &Flags, const System::OleVariant &TargetFrameName)/* overload */;
void __fastcall Navigate(const System::WideString URL, const System::OleVariant &Flags, const System::OleVariant &TargetFrameName, const System::OleVariant &PostData)/* overload */;
void __fastcall Navigate(const System::WideString URL, const System::OleVariant &Flags, const System::OleVariant &TargetFrameName, const System::OleVariant &PostData, const System::OleVariant &Headers)/* overload */;

プロパティ

種類 可視性 ソース ユニット
procedure
function
public
SHDocVw.pas
SHDocVw.hpp
SHDocVw TWebBrowser

説明

Navigate は,URL のパス名で識別するリソースにジャンプします。

Navigate を使用すると,特定のリソースを見つけてダウンロードできます。Navigate は,HTTP メッセージを指定された URL に送って結果を表示したり,指定されたファイルの結果を単純に表示したりできます。

URL は,Web ブラウザが表示するファイルの UNC パス名か,Web ブラウザが表示するインターネットリソースの Uniform Resource Locator を指定します。

Flags は,リソースをヒストリリストに追加するかどうか,フォームをキャッシュから読み出すかキャッシュに書き込むか,新しいウィンドウでリソースを表示するかどうかを指定する一連の値です。これは,以下の値を 0 個以上合計したものです。



定数 意味

navOpenInNewWindow

1

リソースまたはファイルを新しいウィンドウで開く。

navNoHistory

2

リソースまたはファイルをヒストリリストに追加しない。新しいページがリストの現在のページになる。

navNoReadFromCache

4

この操作のディスクキャッシュから読み出さない。

navNoWriteToCache

8

この操作の結果をディスクキャッシュに書き込まない。

navAllowAutosearch

16

操作が失敗すると,Web ブラウザは共通のルートドメイン(.com,.edu など)を操作しようとする。もしそれでも失敗したら,URL が検索エンジンに渡される。



TargetFrameName は,リソースを表示するフレームの名前です。ただし,リソースを名前付きフレームに表示してはいけない場合には NULL です。

PostData は,Navigate を使って HTTP POST メッセージを生成するときにサーバーに送られるデータを保持します。PostData が NULL の場合,Navigate は HTTP GET メッセージを生成します。URL が HTTP URL を指定しない場合は,PostData は無視されます。

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

メモ:  URL で表現できない場所(たとえば,項目識別子リスト)にジャンプするには,かわりに Navigate2 メソッドを使用します。

関連項目