CHtmlView::Navigate2

更新 : 2007 年 11 月

URL で指定されたリソース、または完全パスで指定されたファイルに移動します。

void Navigate2(
   LPITEMIDLIST pIDL,
   DWORD dwFlags = 0,
   LPCTSTR lpszTargetFrameName = NULL 
);
void Navigate2(
   LPCTSTR lpszURL,
   DWORD dwFlags = 0,
   LPCTSTR lpszTargetFrameName = NULL,
   LPCTSTR lpszHeaders = NULL,
   LPVOID lpvPostData = NULL,
   DWORD dwPostDataLen = 0 
);
void Navigate2(
   LPCTSTR lpszURL,
   DWORD dwFlags,
   CByteArray& baPostedData,
   LPCTSTR lpszTargetFrameName = NULL,
   LPCTSTR lpszHeader = NULL 
);

パラメータ

  • pIDL
    ITEMIDLIST 構造体へのポインタ。

  • dwFlags
    リソースを履歴リストに追加するかどうか、キャッシュの書き込み/読み取りを行うかどうか、およびリソースを新しいウィンドウに表示するかどうかを指定する変数のフラグ。この変数には、BrowserNavConstants 列挙型で定義されている値を組み合わせて指定できます。

  • lpszTargetFrameName
    リソースを表示するフレームの名前を格納した文字列へのポインタ。

  • lpszURL
    URL が含まれている文字列へのポインタ。

  • lpvPostData
    HTTP POST トランザクションによって送信するデータ。たとえば、HTML 形式で収集したデータを送信するには、POST トランザクションを使用します。このパラメータでポスト データを指定しないと、HTTP GET トランザクションが発行されます。URL に HTTP URL 以外を指定すると、このパラメータは無視されます。

  • dwPostDataLen
    パラメータ lpvPostData が指すデータのバイト単位の長さ。

  • lpszHeaders
    サーバーに送る HTTP ヘッダー群を指定する値へのポインタ。このヘッダー群は既定の Internet Explorer ヘッダー群に追加されます。サーバーに任せる処理、サーバーに渡すデータの型、ステータス コードなどをヘッダーで指定できます。URL に HTTP URL 以外を指定すると、このパラメータは無視されます。

  • baPostedData
    CByteArray オブジェクトへの参照。

解説

このメンバ関数は Navigate メンバ関数の拡張です。パラメータ pIDL で指定した特殊なフォルダ (デスクトップやマイ コンピュータなど) を閲覧できます。

Internet Explorer と WebBrowser コントロールに使用できます。

使用例

void CMyHtmlView::OnGoToMicrosoft()
{
   Navigate2(_T("http://home.microsoft.com"));
}

必要条件

ヘッダー : afxhtml.h

参照

参照

CHtmlView クラス

階層図

CHtmlView::Navigate

IWebBrowser2::Navigate2

その他の技術情報

CHtmlView のメンバ