SHDocVw.IWebBrowser.Navigate
Delphi
procedure Navigate(const URL: WideString; const Flags: OleVariant; const TargetFrameName: OleVariant; const PostData: OleVariant; const Headers: OleVariant); safecall;
C++
virtual HRESULT __safecall Navigate(const System::WideString URL, const System::OleVariant &Flags, const System::OleVariant &TargetFrameName, const System::OleVariant &PostData, const System::OleVariant &Headers) = 0 ;
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
procedure function |
public | SHDocVw.pas SHDocVw.hpp |
SHDocVw | IWebBrowser |
説明
Navigate は、パス名または URL で指定されたリソースに移動します。
特定のリソースに移動、またはそのリソースをダウンロードするには Navigate を使用します。Navigate を利用すると、指定した URL に HTTP メッセージを送信してその結果を表示したり、指定したファイルの結果を単純に表示できます。
URL は、ファイルの UNC パス名、または Web ブラウザで表示するインターネット リソースの Uniform Resource Locator を表します。
Flags は、そのリソースを履歴リストに追加するかどうか、キャッシュからの読み取りやキャッシュへの書き込みを行うかどうか、そのリソースを新規ウィンドウに表示するかどうかを指定するための値セットです。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 オブジェクトを参照）。
メモ： URL として表現できない場所（たとえば、項目識別子リスト）に移動するには、代わりに Navigate2 を使用します。