INewWindowManager::EvaluateNewWindow メソッド (shobjidl_core.h)
表示しようとしている新しいウィンドウに関するデータを受け入れ、ユーザーの設定に基づいてウィンドウを開くことを許可するかどうかを決定します。
構文
HRESULT EvaluateNewWindow(
[in] LPCWSTR pszUrl,
[in] LPCWSTR pszName,
[in] LPCWSTR pszUrlContext,
[in] LPCWSTR pszFeatures,
[in] BOOL fReplace,
[in] DWORD dwFlags,
[in] DWORD dwUserActionTime
);
パラメーター
[in] pszUrl
種類: LPCWSTR
新しいウィンドウに表示されるコンテンツの URL を含むバッファーへのポインター。
[in] pszName
種類: LPCWSTR
新しいウィンドウの名前を含むバッファーへのポインター。 このパラメーターは、NULL でもかまいません。
[in] pszUrlContext
種類: LPCWSTR
新しいウィンドウを開くコマンドを発行した URL を含むバッファーへのポインター。
[in] pszFeatures
種類: LPCWSTR
新しいウィンドウの機能文字列を含むバッファーへのポインター。 この値は NULL にすることができます。
[in] fReplace
種類: BOOL
pszUrl で指定された新しいコンテンツが新しいコンテンツを作成する代わりに既存のウィンドウに読み込まれるときに使用されるブール値。 新 しい文書が履歴リストの現在の文書を置き換える必要がある場合は TRUE。 新 しいドキュメントに新しいエントリを指定する必要がある場合は FALSE。
[in] dwFlags
型: DWORD
新しいウィンドウを開く呼び出しに関する状況情報を提供する NWMF 列挙からのフラグまたはフラグ。 フラグが必要ない場合、この値は 0 にすることができます。
[in] dwUserActionTime
型: DWORD
最後のユーザー アクションが発生したときのティック数。 アクションが発生した時間を調べるには、 GetTickCount を呼び出し、結果をこのパラメーターの値と比較します。
戻り値
種類: HRESULT
次のような標準エラー コードを返します。
リターン コード | 説明 |
---|---|
|
ウィンドウの表示を許可します。 |
|
ウィンドウの表示をブロックします。 |
|
ホストされた WebBrowser コントロールに INewWindowManager を実装すると、この値は WebBrowser コントロールに既定の実装を使用するように指示します。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | WINDOWS XP と SP2 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |
[DLL] | Shell32.dll |