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 メソッドを使用します。

関連項目