IWebBrowser2

COMIDispatch (デュアル)

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IIDd30c1661-cdaf-11d0-8a3e-00c04fc9e26e継承元IWebBrowserApp呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl52

公式ドキュメント

WebBrowser コントロール(Microsoft ActiveX コントロール)によって実装されるメソッド、または InternetExplorer アプリケーションのインスタンス(OLE オートメーション)によって実装されるメソッドを公開します。

メソッド 19

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 52 HRESULT Navigate2(VARIANT* URL, VARIANT* Flags, VARIANT* TargetFrameName, VARIANT* PostData, VARIANT* Headers)

URL	VARIANT*	in	移動先の URL、ファイルパス、または PIDL を保持する VARIANT へのポインタである。
Flags	VARIANT*	inoptional	ナビゲーション動作を制御するフラグ(BrowserNavConstants)を保持する VARIANT へのポインタである。省略可能である。
TargetFrameName	VARIANT*	inoptional	表示先となるフレーム名を保持する VARIANT へのポインタである。省略可能である。
PostData	VARIANT*	inoptional	HTTP POST 操作で送信するデータを保持する VARIANT へのポインタである。省略可能である。
Headers	VARIANT*	inoptional	要求に付加する追加 HTTP ヘッダーを保持する VARIANT へのポインタである。省略可能である。

vtbl 53 HRESULT QueryStatusWB(OLECMDID cmdID, OLECMDF* pcmdf)

cmdID	OLECMDID	in	状態を問い合わせるコマンドの識別子(OLECMDID)を指定する。
pcmdf	OLECMDF*	out	コマンドの状態(有効、無効、表示状態など)を表す OLECMDF を受け取るポインタである。

vtbl 54 HRESULT ExecWB(OLECMDID cmdID, OLECMDEXECOPT cmdexecopt, VARIANT* pvaIn, VARIANT* pvaOut)

cmdID	OLECMDID	in	実行するコマンドの識別子(OLECMDID)を指定する。
cmdexecopt	OLECMDEXECOPT	in	コマンドの実行方法(ユーザーへの確認の有無など)を示す OLECMDEXECOPT を指定する。
pvaIn	VARIANT*	inoptional	コマンドへの入力引数を保持する VARIANT へのポインタである。省略可能である。
pvaOut	VARIANT*	inoutoptional	コマンドの出力を受け取る VARIANT へのポインタである。省略可能である。

vtbl 55 HRESULT ShowBrowserBar(VARIANT* pvaClsid, VARIANT* pvarShow, VARIANT* pvarSize)

pvaClsid	VARIANT*	in	表示または非表示にするブラウザーバーの CLSID を保持する VARIANT へのポインタである。
pvarShow	VARIANT*	inoptional	ブラウザーバーを表示するか非表示にするかを示す VARIANT へのポインタである。
pvarSize	VARIANT*	inoptional	ブラウザーバーのサイズを指定する VARIANT へのポインタである。

vtbl 56 HRESULT get_ReadyState(READYSTATE* plReadyState)

plReadyState

READYSTATE*

out

ブラウザーの現在の準備状態(READYSTATE)を受け取るポインタである。

vtbl 57 HRESULT get_Offline(VARIANT_BOOL* pbOffline)

pbOffline

VARIANT_BOOL*

out

オフライン動作中かどうかを受け取る VARIANT_BOOL へのポインタである。

vtbl 58 HRESULT put_Offline(VARIANT_BOOL bOffline)

bOffline

VARIANT_BOOL

オフラインで動作させるかどうかを示す VARIANT_BOOL を指定する。

vtbl 59 HRESULT get_Silent(VARIANT_BOOL* pbSilent)

pbSilent

VARIANT_BOOL*

out

ダイアログやエラーメッセージを抑制するサイレントモードかどうかを受け取る VARIANT_BOOL へのポインタである。

vtbl 60 HRESULT put_Silent(VARIANT_BOOL bSilent)

bSilent

VARIANT_BOOL

サイレントモードにするかどうかを示す VARIANT_BOOL を指定する。

vtbl 61 HRESULT get_RegisterAsBrowser(VARIANT_BOOL* pbRegister)

pbRegister

VARIANT_BOOL*

out

このインスタンスがトップレベルブラウザーとして登録されているかどうかを受け取る VARIANT_BOOL へのポインタである。

vtbl 62 HRESULT put_RegisterAsBrowser(VARIANT_BOOL bRegister)

bRegister

VARIANT_BOOL

このインスタンスをトップレベルブラウザーとして登録するかどうかを示す VARIANT_BOOL を指定する。

vtbl 63 HRESULT get_RegisterAsDropTarget(VARIANT_BOOL* pbRegister)

pbRegister

VARIANT_BOOL*

out

このインスタンスがナビゲーション用のドロップターゲットとして登録されているかどうかを受け取る VARIANT_BOOL へのポインタである。

vtbl 64 HRESULT put_RegisterAsDropTarget(VARIANT_BOOL bRegister)

bRegister

VARIANT_BOOL

このインスタンスをドロップターゲットとして登録するかどうかを示す VARIANT_BOOL を指定する。

vtbl 65 HRESULT get_TheaterMode(VARIANT_BOOL* pbRegister)

オブジェクトがシアターモードであるかどうかを設定または取得します。(Get)

pbRegister

VARIANT_BOOL*

out

シアターモード(全画面表示)かどうかを受け取る VARIANT_BOOL へのポインタである。

解説(Remarks)

シアターモードでは、オブジェクトのメインウィンドウが画面全体を占め、最小限のナビゲーションボタンを備えたツールバーを表示します。また、画面右上にはステータスバーが表示されます。シアターモードでは、History や Favorites などのエクスプローラーバーが、画面の左端に自動的に隠れるペインとして表示されます。

TheaterMode を設定すると(VARIANT_FALSE に設定した場合でも)、IWebBrowser2::AddressBar および IWebBrowser2::ToolBar プロパティの値が VARIANT_TRUE にリセットされます。TheaterMode プロパティを設定した後に、アドレスバーとツールバーを無効化してください。

WebBrowser オブジェクトはこのプロパティの値を保存しますが、それ以外では無視します。

vtbl 66 HRESULT put_TheaterMode(VARIANT_BOOL bRegister)

オブジェクトがシアターモードであるかどうかを設定または取得します。(Put)

bRegister

VARIANT_BOOL

シアターモードにするかどうかを示す VARIANT_BOOL を指定する。

解説(Remarks)

WebBrowser オブジェクトはこのプロパティの値を保存しますが、それ以外では無視します。

vtbl 67 HRESULT get_AddressBar(VARIANT_BOOL* Value)

Value

VARIANT_BOOL*

out

アドレスバーが表示されているかどうかを受け取る VARIANT_BOOL へのポインタである。

vtbl 68 HRESULT put_AddressBar(VARIANT_BOOL Value)

Value

VARIANT_BOOL

アドレスバーを表示するかどうかを示す VARIANT_BOOL を指定する。

vtbl 69 HRESULT get_Resizable(VARIANT_BOOL* Value)

Value

VARIANT_BOOL*

out

ウィンドウがサイズ変更可能かどうかを受け取る VARIANT_BOOL へのポインタである。

vtbl 70 HRESULT put_Resizable(VARIANT_BOOL Value)

Value

VARIANT_BOOL

ウィンドウをサイズ変更可能にするかどうかを示す VARIANT_BOOL を指定する。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IWebBrowser2 "{D30C1661-CDAF-11D0-8A3E-00C04FC9E26E}"
#usecom global IWebBrowser2 IID_IWebBrowser2 "{8856F961-340A-11D0-A96B-00C04FD705A2}"
#comfunc global IWebBrowser2_Navigate2                 52 var,var,var,var,var
#comfunc global IWebBrowser2_QueryStatusWB             53 int,var
#comfunc global IWebBrowser2_ExecWB                    54 int,int,var,var
#comfunc global IWebBrowser2_ShowBrowserBar            55 var,var,var
#comfunc global IWebBrowser2_get_ReadyState            56 var
#comfunc global IWebBrowser2_get_Offline               57 var
#comfunc global IWebBrowser2_put_Offline               58 int
#comfunc global IWebBrowser2_get_Silent                59 var
#comfunc global IWebBrowser2_put_Silent                60 int
#comfunc global IWebBrowser2_get_RegisterAsBrowser     61 var
#comfunc global IWebBrowser2_put_RegisterAsBrowser     62 int
#comfunc global IWebBrowser2_get_RegisterAsDropTarget  63 var
#comfunc global IWebBrowser2_put_RegisterAsDropTarget  64 int
#comfunc global IWebBrowser2_get_TheaterMode           65 var
#comfunc global IWebBrowser2_put_TheaterMode           66 int
#comfunc global IWebBrowser2_get_AddressBar            67 var
#comfunc global IWebBrowser2_put_AddressBar            68 int
#comfunc global IWebBrowser2_get_Resizable             69 var
#comfunc global IWebBrowser2_put_Resizable             70 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IWebBrowser2 "{D30C1661-CDAF-11D0-8A3E-00C04FC9E26E}"
#usecom global IWebBrowser2 IID_IWebBrowser2 "{8856F961-340A-11D0-A96B-00C04FD705A2}"
#comfunc global IWebBrowser2_Navigate2                 52 sptr,sptr,sptr,sptr,sptr
#comfunc global IWebBrowser2_QueryStatusWB             53 int,sptr
#comfunc global IWebBrowser2_ExecWB                    54 int,int,sptr,sptr
#comfunc global IWebBrowser2_ShowBrowserBar            55 sptr,sptr,sptr
#comfunc global IWebBrowser2_get_ReadyState            56 sptr
#comfunc global IWebBrowser2_get_Offline               57 sptr
#comfunc global IWebBrowser2_put_Offline               58 int
#comfunc global IWebBrowser2_get_Silent                59 sptr
#comfunc global IWebBrowser2_put_Silent                60 int
#comfunc global IWebBrowser2_get_RegisterAsBrowser     61 sptr
#comfunc global IWebBrowser2_put_RegisterAsBrowser     62 int
#comfunc global IWebBrowser2_get_RegisterAsDropTarget  63 sptr
#comfunc global IWebBrowser2_put_RegisterAsDropTarget  64 int
#comfunc global IWebBrowser2_get_TheaterMode           65 sptr
#comfunc global IWebBrowser2_put_TheaterMode           66 int
#comfunc global IWebBrowser2_get_AddressBar            67 sptr
#comfunc global IWebBrowser2_put_AddressBar            68 int
#comfunc global IWebBrowser2_get_Resizable             69 sptr
#comfunc global IWebBrowser2_put_Resizable             70 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。