窗口嵌入网页：WebBrowser简述-Aet

Bingliaolong 2026-01-31 19:34 Aet | 隐藏边栏 | 抢沙发 | 5 0

文章评分 1 次，平均分 5.0 ：

`WebBrowser`

概述

WebBrowser 控件是微软提供的用于在 Windows 应用程序中嵌入浏览器功能的 ActiveX 控件
基于 Internet Explorer 的 Trident 渲染引擎

框架

核心接口：
1. 主要通过 IWebBrowser2 COM 接口进行编程控制。
渲染引擎
1. 使用 Internet Explorer 的 Trident 引擎渲染网页内容
宿主方式
1. 作为 ActiveX 控件托管在应用程序窗口中。
支持框架
1. 可在 MFC、ATL、WTL、原生 Win32 等多种 C++ 框架中使用

`MFC` 中使用

MFC 提供了 CHtmlView 和 CWebBrowser2 封装类，简化了 WebBrowser 控件的使用
CHtmlView
1. 创建基于 CHtmlView 的视图类，自动包含浏览器功能。调用 Navigate2 方法加载页面
2. 重写 OnBeforeNavigate2、OnDocumentComplete 等虚函数处理事件
CWebBrowser2：
1. 在对话框或窗口中动态创建控件。调用 Create 方法指定位置和大小
2. 通过成员函数控制浏览器行为

`ATL` 中使用

ATL 提供更底层的 COM 支持，需要手动处理更多细节
使用 CAxWindow 承载 ActiveX 控件
通过 QueryControl 获取 IWebBrowser2 接口
实现 IDispEventImpl 来接收浏览器事件

原生 `Win32`中使用

完全使用 COM API 进行操作，需要创建 AtlAxWin 窗口类承载控件
使用 CoCreateInstance 创建 WebBrowser 实例
通过连接点（Connection Points）机制接收事件

注意事项

浏览器模式控制
1. 默认情况下 WebBrowser 控件运行在 IE7 兼容模式
2. 需要通过注册表设置 FEATURE_BROWSER_EMULATION 来指定模拟的 IE 版本(如 IE11)
3. 注册表路径:HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BROWSER_EMULATION
  键名为应用程序名称,值为版本号(如 11001 表示 IE11)
线程模型
1. 必须在 STA(Single-Threaded Apartment)线程中使用
2. 调用 CoInitializeEx 时使用 COINIT_APARTMENTTHREADED 参数
事件接收
1. 需要实现 IDispatch 接口来接收事件通知,或使用 ATL 的 IDispEventImpl 简化事件处理
2. 常见事件包括 BeforeNavigate2、NavigateComplete2、DocumentComplete 等
脚本交互:
1. 通过 IHTMLDocument2 接口访问 DOM
2. 使用 window.external 机制实现 JavaScript 调用 C++ 代码,需要实现 IDocHostUIHandler 接口
内存管理
1. 使用 COM 智能指针(如 CComPtr 或 _com_ptr_t)管理接口生命周期
2. 确保在适当时机释放接口,调用 Release 方法

`IWebBrowser2`

概述

IWebBrowser2 是 WebBrowser 控件的 COM 接口,基于 Internet Explorer (Trident 引擎)
它允许在 Windows 应用程序中嵌入浏览器功能,支持 ActiveX、COM 等传统技术
现在已被 WebView2 取代

使用方法

初始化 COM 库:
1. 调用 CoInitialize 或 CoInitializeEx 初始化 COM 环境
创建实例:
1. 使用 CoCreateInstance 创建 WebBrowser 控件实例,CLSID 为 CLSID_WebBrowser
获取接口:
1. 通过 QueryInterface 获取 IWebBrowser2 接口指针
导航页面:
1. 调用 Navigate 或 Navigate2 方法加载 URL
事件处理:
1. 实现 DWebBrowserEvents2 接口来处理浏览器事件(如页面加载完成、导航等)

`CWebBrowserHost`

实现

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

#pragma once

#include <atlbase.h>

#include <atlwin.h>

#include <exdisp.h> // 定义了 IWebBrowser2

#include <string>

#include <vector>

#include "web/CJsExternal.h"

#include "web/WebBrowserEventSink.h"

enum class msg_notify : int {

em_navigate_err = 1234,

em_doc_succ,

};

class CWebBrowserHost : public CWebBrowserEventSink::delegate

{

public:

class helper {

public:

virtual void load_err() = 0;

virtual void load_succ() = 0;

};

private:

::CComPtr<CJsExternal> m_spExternal;

CComPtr<CWebBrowserEventSink> m_spEventSink;

HWND m_hParent;

helper* helper_;

protected:

::CComPtr<IWebBrowser2> m_spWebBrowser; // 智能指针持有浏览器接口

CAxWindow m_wndView; // ATL ActiveX 容器窗口

public:

CWebBrowserHost(CWebBrowserHost::helper* helper) : m_spWebBrowser(nullptr), helper_(helper) {

// 创建 External 对象

m_spExternal = new CJsExternal();

}

virtual ~CWebBrowserHost() { Destroy(); }

bool Create(HWND parentWnd, RECT& rect)

{

// 必须初始化 ATL 宿主环境

AtlAxWinInit();

m_hParent = parentWnd;

// 创建宿主窗口，指定 ProgID 为 "Shell.Explorer.2" (即 WebBrowser 控件)

if (parentWnd != NULL) {

m_wndView.Create(parentWnd, rect, _T("Shell.Explorer.2"), WS_CHILD | WS_CLIPCHILDREN);

}

else

{

m_wndView.Create(parentWnd, rect, _T("Shell.Explorer.2"), WS_POPUP);

}

if (!m_wndView.IsWindow())

return false;

HRESULT hr = m_wndView.QueryControl(IID_IWebBrowser2, (void**)&m_spWebBrowser);

if (!SUCCEEDED(hr) || m_spWebBrowser == nullptr)

return false;

m_spWebBrowser->put_Silent(VARIANT_TRUE);

hr = m_wndView.SetExternalDispatch(m_spExternal);

m_spEventSink = new CWebBrowserEventSink(this);

hr = m_spEventSink->Advise(m_spWebBrowser);

return SUCCEEDED(hr);

}

// 2. 调整大小

void Resize(const RECT& rect)

{

if (m_wndView.IsWindow())

{

m_wndView.MoveWindow(&rect);

}

// 3. 导航到 URL

void Navigate(const std::wstring& url)

{

if (!m_spWebBrowser) return;

CComBSTR bstrURL(url.c_str());

CComVariant vEmpty; // 空参数

// Navigate 接口需要 VARIANT 参数，通常传空即可

m_spWebBrowser->Navigate(bstrURL, &vEmpty, &vEmpty, &vEmpty, &vEmpty);

}

// 4. 执行简单的 JavaScript 脚本

// 例如: ExecuteScript(L"alert('Hello from C++');");

bool ExecuteScript(const std::wstring& script)

{

if (!m_spWebBrowser) return false;

::CComPtr<IDispatch> spDisp;

HRESULT hr = m_spWebBrowser->get_Document(&spDisp);

if (FAILED(hr) || !spDisp) return false;

::CComPtr<IHTMLDocument2> spDoc;

hr = spDisp->QueryInterface(IID_IHTMLDocument2, (void**)&spDoc);

if (FAILED(hr) || !spDoc) return false;

::CComPtr<IHTMLWindow2> spWin;

hr = spDoc->get_parentWindow(&spWin);

if (FAILED(hr) || !spWin) return false;

CComBSTR bstrScript(script.c_str());

CComBSTR bstrLang(L"JavaScript");

CComVariant vRet;

return SUCCEEDED(spWin->execScript(bstrScript, bstrLang, &vRet));

}

// 用法: BindFunction(L"add", [](auto args) { return args[0].intVal + args[1].intVal; });

void BindFunction(const std::wstring& funcName, JsCallback callback)

{

if (m_spExternal) m_spExternal->RegisterFunction(funcName, callback);

}

/*CComVariant CallFunctionBind(const std::wstring& funcName, const std::vector<CComVariant>& args) {

if (!m_spExternal) {

return false;

}

CComVariant res = m_spExternal->call_test(funcName, args);

int i = 0;

}*/

bool CallJSFunction(const std::wstring& funcName, const std::vector<CComVariant>& args)

{

if (!m_spWebBrowser) return false;

CComPtr<IDispatch> spScript;

HRESULT hr = m_spWebBrowser->get_Document(&spScript); // 获取 Document 对象作为 Dispatch

if (FAILED(hr)) return false;

CComPtr<IHTMLDocument2> spDoc;

spScript->QueryInterface(&spDoc);

if (!spDoc) return false;

CComPtr<IHTMLWindow2> spWin;

spDoc->get_parentWindow(&spWin); // 获取 Window 对象

if (!spWin) return false;

// 这里的逻辑稍微复杂：我们需要 GetIDsOfNames 找到 JS 函数，然后 Invoke

// 为了简化，这里演示最通用的 IDispatch::Invoke 调用方式

CComPtr<IDispatch> spWinDisp;

spWin->QueryInterface(&spWinDisp);

DISPID dispid;

LPOLESTR name = (LPOLESTR)funcName.c_str();

hr = spWinDisp->GetIDsOfNames(IID_NULL, &name, 1, LOCALE_USER_DEFAULT, &dispid);

if (FAILED(hr)) return false;

// 构造参数

DISPPARAMS params = { NULL, NULL, 0, 0 };

std::vector<VARIANT> vArgs(args.size());

if (!args.empty()) {

// 参数倒序放入

for (size_t i = 0; i < args.size(); ++i) {

vArgs[args.size() - 1 - i] = args[i];

}

params.rgvarg = vArgs.data();

params.cArgs = (UINT)args.size();

}

CComVariant result;

hr = spWinDisp->Invoke(dispid, IID_NULL, LOCALE_USER_DEFAULT, DISPATCH_METHOD, &params, &result, NULL, NULL);

return SUCCEEDED(hr);

}

// 5. 常用浏览器操作

void GoBack() { if (m_spWebBrowser) m_spWebBrowser->GoBack(); }

void GoForward() { if (m_spWebBrowser) m_spWebBrowser->GoForward(); }

void Refresh() { if (m_spWebBrowser) m_spWebBrowser->Refresh(); }

void Stop() { if (m_spWebBrowser) m_spWebBrowser->Stop(); }

// 获取原始接口，以便子类进行高级操作

IWebBrowser2* GetBrowserInterface() { return m_spWebBrowser; }

HWND GetHostWindow() { return m_wndView.m_hWnd; }

void Destroy()

{

if (m_spEventSink) {

m_spEventSink->Unadvise();

m_spEventSink.Release();

}

if (m_spWebBrowser)

{

m_spWebBrowser->Stop();

m_spWebBrowser.Release();

}

if (m_wndView.IsWindow())

{

m_wndView.DestroyWindow();

}

private:

void Show() {

if (m_wndView.IsWindow()) {

m_wndView.ShowWindow(SW_SHOW);

}

void Hide() {

if (m_wndView.IsWindow()) {

m_wndView.ShowWindow(SW_HIDE);

}

private:

// from delegate

void on_navigate_err() override {

this->Hide();

if (helper_) {

helper_->load_err();

}

void on_doc_succ() override {

this->Show();

if (helper_) {

helper_->load_succ();

}

};

在主窗口中持有指针

std::unique_ptr<CWebBrowserHost> browser_hoset_;

CMainWnd::CMainWnd() : browser_hoset_(std::make_unique<CWebBrowserHost>(this)) {

}

create消息时机注册函数，关联窗口
1. 加载网页

void CMainWnd::OnWndCreate()

{

SetWindowText(MAIN_NAME);

HICON hIcon = AtlLoadIconImage(IDI_ICON1, LR_DEFAULTCOLOR, ::GetSystemMetrics(SM_CXICON), ::GetSystemMetrics(SM_CYICON));

SetIcon(hIcon, TRUE);

shadow_.Create(m_hWnd);

shadow_.SetSize(5);

shadow_.SetPosition(0, 0);

shadow_.SetDarkness(30);

bind_funcs();

RECT rcClient;

::GetClientRect(m_hWnd, &rcClient);

this->browser_hoset_->Create(m_hWnd, rcClient);

InitCtrl();

InitWirelessCtrl();

m_pWirelessGroup->SetVisible(FALSE, TRUE);

::SetWindowPos(this->GetHWND(), HWND_TOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE);

AddTimer((UINT)APP_TIMER_ID::TIMER_TRAY_TOP, 1 * 1000);

AddTimer((UINT)APP_TIMER_ID::TIMER_TRAY_WATCHER, 10 * 1000);

ProcessCommandline(*CCommandParser::GetInstance());

if (browser_hoset_) {

browser_hoset_->Navigate(L"https://test-admin.test.com.cn/web/index.html");

}

start_tskbar();

}

void CMainWnd::bind_funcs() {

if (!browser_hoset_) {

return;

}

HWND hTmp = m_hWnd;

browser_hoset_->BindFunction(L"close", [hTmp](const std::vector<CComVariant>& var) {

PostQuitMessage(0);

return CComVariant(1);

});

browser_hoset_->BindFunction(L"ready", [this](const std::vector<CComVariant>& var) {

LOG << L"CMainWnd::Ready";

do {

if (!browser_hoset_) {

break;

}

bReady_ = true;

if (browser_hoset_) {

this->browser_hoset_->Navigate(L"https://test-admin.test.com.cn/web/index.html");

} else {

{

std::wstring tmp_action = L"ready_fail";

static_dot(tmp_action, g_Exefrom);

}

PostMessage(WM_CLOSE, 0, 0);

}

} while (false);

return CComVariant(1);

});

browser_hoset_->BindFunction(L"move", [hTmp](const std::vector<CComVariant>& var) {

LOG << L"CMainWnd::move";

::ReleaseCapture();

::SendMessage(hTmp, WM_NCLBUTTONDOWN, HTCAPTION, 0);

return CComVariant(1);

});

browser_hoset_->BindFunction(L"sys_scan", [this](const std::vector<CComVariant>& var) {

this->IsReady = TRUE;

KillTimer((UINT)APP_TIMER_ID::TIMER_TRAY_WATCHER);

if (pInfoReady) {

::PostMessage(this->m_hWnd, WM_GET_SYSINFO, (WPARAM)0, (LPARAM)0);

return CComVariant(1);

}

CComDataMgrProxy::CreateInstance(&pInfoReady);

if (pInfoReady) {

pInfoReady->Init(m_hWnd);

LOG << L"SysInfoScan::START";

}

return CComVariant(1);

});

browser_hoset_->BindFunction(L"dot", [this](const std::vector<CComVariant>& var) {

LOG << L"CMainWnd::dot";

if (var.size() >= 2) {

if (var[0].vt == VT_BSTR && var[1].vt == VT_BSTR) {

std::wstring type = var[0].bstrVal;

std::wstring action = var[1].bstrVal;

if (g_Exefrom.empty()) {

std::wstring tmp = L"&channel1=" + g_SourceString;

tmp += L"&channel2=";

} else {

std::wstring tmp = L"&channel1=" + g_SourceString;

tmp += L"&channel2=" + g_Exefrom;

}

return CComVariant(1);

});

}

RECT rcClient;

::GetClientRect(m_hWnd, &rcClient);

this->browser_hoset_->Create(m_hWnd, rcClient);

if (browser_hoset_) {

browser_hoset_->Navigate(L"https://test-admin.tset.com.cn/web/index.html");

}

`CJsExternal`

提供注册javascript函数

100

101

102

103

104

105

106

107

108

109

110

#pragma once

#include <map>

#include <functional>

#include <string>

#include <vector>

// 使用简单的 Variant 转换辅助

#include <comutil.h>

#pragma comment(lib, "comsuppw.lib")

// 定义回调函数类型：接收参数列表，返回一个 VARIANT 结果

using JsCallback = std::function<CComVariant(const std::vector<CComVariant>&)>;

/**

* CJsExternal

* 一个轻量级的 IDispatch 实现，用于处理 window.external.FuncName()

class CJsExternal : public IDispatch

{

private:

long m_refCount = 1;

std::map<std::wstring, DISPID> m_nameToId;

std::map<DISPID, JsCallback> m_idToCallback;

DISPID m_nextId = 1;

public:

// 注册 C++ 函数供 JS 调用

void RegisterFunction(const std::wstring& name, JsCallback callback)

{

m_nameToId[name] = m_nextId;

m_idToCallback[m_nextId] = callback;

m_nextId++;

}

/*CComVariant call_test(const std::wstring& funcName, const std::vector<CComVariant>& args) {

auto it = m_nameToId.find(funcName);

if (it == m_nameToId.end()) {

return CComVariant();

}

DISPID dispId = it->second;

auto callbackIt = m_idToCallback.find(dispId);

if (callbackIt == m_idToCallback.end()) {

return CComVariant();

}

return callbackIt->second(args);

}*/

// --- IUnknown 实现 ---

STDMETHODIMP QueryInterface(REFIID riid, void** ppv) override

{

if (riid == IID_IUnknown || riid == IID_IDispatch) {

*ppv = static_cast<IDispatch*>(this);

AddRef();

return S_OK;

}

*ppv = NULL;

return E_NOINTERFACE;

}

STDMETHODIMP_(ULONG) AddRef() override { return InterlockedIncrement(&m_refCount); }

STDMETHODIMP_(ULONG) Release() override {

ULONG uCount = InterlockedDecrement(&m_refCount);

if (uCount == 0) delete this;

return uCount;

}

// --- IDispatch 核心实现 ---

// 1. JS 询问函数名对应的 ID

STDMETHODIMP GetIDsOfNames(REFIID, LPOLESTR* rgszNames, UINT cNames, LCID, DISPID* rgDispId) override

{

if (cNames == 0) return E_INVALIDARG;

std::wstring funcName = rgszNames[0];

auto it = m_nameToId.find(funcName);

if (it != m_nameToId.end()) {

*rgDispId = it->second;

return S_OK;

}

return DISP_E_UNKNOWNNAME;

}

// 2. JS 执行函数 (通过 ID)

STDMETHODIMP Invoke(DISPID dispIdMember, REFIID, LCID, WORD wFlags, DISPPARAMS* pDispParams, VARIANT* pVarResult, EXCEPINFO*, UINT*) override

{

auto it = m_idToCallback.find(dispIdMember);

if (it == m_idToCallback.end()) return DISP_E_MEMBERNOTFOUND;

// 解析参数 (注意：ActiveX 参数顺序是反的)

std::vector<CComVariant> args;

if (pDispParams && pDispParams->cArgs > 0) {

for (int i = pDispParams->cArgs - 1; i >= 0; i--) {

args.push_back(pDispParams->rgvarg[i]);

}

// 调用 C++ 回调

CComVariant result = it->second(args);

// 返回结果给 JS

if (pVarResult) {

*pVarResult = result;

}

return S_OK;

}

// --- 未使用的 IDispatch 方法 ---

STDMETHODIMP GetTypeInfoCount(UINT*) override { return E_NOTIMPL; }

STDMETHODIMP GetTypeInfo(UINT, LCID, ITypeInfo**) override { return E_NOTIMPL; }

};

在html里面调用C++注册的函数

1	window.external.sys_scan()

在html里面提供javascript函数给C++调用

function scan_sys_result(data) {

$("#sys-scan-loading").hide();

var text = "";

try {

text = (typeof data === "string") ? data : JSON.stringify(data, null, 2);

} catch (e) {

text = String(data);

}

$("#sys-scan-result").html(text);

}

</script>

LPWSTR lpResult = ComAllFun::StrToWebData(sysInfo.c_str());

std::vector<CComVariant> tmp;

tmp.push_back(CComVariant(lpResult));

browser_hoset_->CallJSFunction(L"scan_sys_result", tmp);

`CWebBrowserEventSink`

相关事件处理

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

#pragma once

#include <atlbase.h>

#include <atlcom.h>

#include <exdisp.h>

#include <exdispid.h>

#include <string>

class CWebBrowserEventSink : public IDispatch {

public:

class delegate {

public:

virtual void on_navigate_err() = 0;

virtual void on_doc_succ() = 0;

};

CWebBrowserEventSink(delegate* helper) : helper_(helper) {

}

virtual ~CWebBrowserEventSink() { Unadvise(); }

HRESULT Advise(IWebBrowser2* pBrowser) {

if (!pBrowser)

return E_POINTER;

web_browser_ = pBrowser;

CComPtr<IConnectionPointContainer> spContainer;

HRESULT hr = pBrowser->QueryInterface(IID_IConnectionPointContainer,

(void**)&spContainer);

if (FAILED(hr))

return hr;

hr = spContainer->FindConnectionPoint(DIID_DWebBrowserEvents2,

&connect_point_);

if (FAILED(hr))

return hr;

hr = connect_point_->Advise(this, &cookie_);

if (SUCCEEDED(hr)) {

OutputDebugStringW(

L"[EventSink] Successfully connected to browser events\n");

}

return hr;

}

void Unadvise() {

if (connect_point_ && cookie_ != 0) {

connect_point_->Unadvise(cookie_);

cookie_ = 0;

OutputDebugStringW(L"[EventSink] Disconnected from browser events\n");

}

connect_point_.Release();

web_browser_.Release();

}

STDMETHODIMP QueryInterface(REFIID riid, void** ppv) override {

if (riid == IID_IUnknown || riid == IID_IDispatch) {

*ppv = static_cast<IDispatch*>(this);

AddRef();

return S_OK;

}

*ppv = NULL;

return E_NOINTERFACE;

}

STDMETHODIMP_(ULONG) AddRef() override {

return InterlockedIncrement(&ref_count_);

}

STDMETHODIMP_(ULONG) Release() override {

ULONG count = InterlockedDecrement(&ref_count_);

if (count == 0)

delete this;

return count;

}

STDMETHODIMP GetTypeInfoCount(UINT* pctinfo) override {

*pctinfo = 0;

return S_OK;

}

STDMETHODIMP GetTypeInfo(UINT, LCID, ITypeInfo**) override {

return E_NOTIMPL;

}

STDMETHODIMP GetIDsOfNames(REFIID, LPOLESTR*, UINT, LCID, DISPID*) override {

return E_NOTIMPL;

}

STDMETHODIMP Invoke(DISPID dispIdMember, // 事件 ID

REFIID,

LCID,

WORD wFlags,

DISPPARAMS* pDispParams, // 事件参数

VARIANT* pVarResult,

EXCEPINFO*,

UINT*) override {

switch (dispIdMember) {

case DISPID_DOCUMENTCOMPLETE:

return OnDocumentComplete(pDispParams);

case DISPID_NAVIGATEERROR:

return OnNavigateError(pDispParams);

case DISPID_BEFORENAVIGATE2:

return OnBeforeNavigate2(pDispParams);

}

return S_OK;

}

virtual HRESULT OnBeforeNavigate2(DISPPARAMS* pParams) {

if (pParams && pParams->cArgs >= 7) {

// rgvarg[5] = URL

VARIANT* pURL = &pParams->rgvarg[5];

VARIANT* pActualURL =

(pURL->vt == (VT_BYREF | VT_VARIANT)) ? pURL->pvarVal : pURL;

std::wstring tmp = pActualURL->bstrVal;

if (pActualURL && pActualURL->vt == VT_BSTR) {

if (tmp.find(L"ieframe.dll/navcancl") == std::wstring::npos) {

m_bNavigationError = false;

}

return S_OK;

}

virtual HRESULT OnDocumentComplete(DISPPARAMS* pParams) {

if (pParams && pParams->cArgs >= 2) {

// pParams->rgvarg[0] = URL (VARIANT*)

// pParams->rgvarg[1] = pDisp (IDispatch*)

VARIANT* pURL = &pParams->rgvarg[0];

if (!pURL) {

return S_OK;

}

VARIANT* pActualURL = pURL;

std::wstring url;

if (pURL->vt == (VT_BYREF | VT_VARIANT)) {

pActualURL = pURL->pvarVal;

if (!pActualURL) {

return S_OK;

}

if (pActualURL->vt != VT_BSTR) {

return S_OK;

}

url = pActualURL->bstrVal;

} else if (pURL->vt == (VT_BYREF | VT_BSTR)) {

url = pURL->bstrVal;

}

IDispatch* pDisp = pParams->rgvarg[1].pdispVal;

if (pDisp && web_browser_) {

CComPtr<IDispatch> spTopDisp;

web_browser_->QueryInterface(IID_IDispatch, (void**)&spTopDisp);

if (pDisp == spTopDisp) {

if (m_bNavigationError) {

OnPageLoadFailed(url);

} else {

OnPageFullyLoaded(url);

}

return S_OK;

}

virtual HRESULT OnNavigateError(DISPPARAMS* pParams) {

if (pParams && pParams->cArgs >= 5) {

// rgvarg[3] = URL

// rgvarg[1] = StatusCode

VARIANT* pURL = &pParams->rgvarg[3];

if (!pURL) {

return S_OK;

}

m_bNavigationError = true;

VARIANT* pActualURL = pURL;

if (pURL->vt == (VT_BYREF | VT_VARIANT)) {

pActualURL = pURL->pvarVal;

if (!pActualURL) {

return S_OK;

}

if (pActualURL->vt != VT_BSTR) {

return S_OK;

}

VARIANT* pStatusCode = &pParams->rgvarg[1];

if (!pStatusCode) {

return S_OK;

}

VARIANT* pActualStatusCode = pStatusCode;

if (pActualStatusCode->vt == (VT_BYREF | VT_VARIANT)) {

pActualStatusCode = pStatusCode->pvarVal;

if (!pActualStatusCode) {

return S_OK;

}

if (pActualStatusCode->vt != VT_I4 && pActualStatusCode->vt != VT_I2) {

return S_OK;

}

std::wstring url = pActualURL->bstrVal ? pActualURL->bstrVal : L"(null)";

int statusCode = (pActualStatusCode->vt == VT_I4)

? pActualStatusCode->lVal

: pActualStatusCode->iVal;

if (helper_) {

helper_->on_navigate_err();

}

return S_OK;

}

virtual void OnPageLoadFailed(const std::wstring& url) {

if (helper_) {

helper_->on_navigate_err();

}

virtual void OnPageFullyLoaded(const std::wstring& url) {

OutputDebugStringW(

(L"[EventSink] ✓ Page Fully Loaded: " + url + L"\n").c_str());

if (helper_) {

helper_->on_doc_succ();

}

private:

long ref_count_ = 1;

DWORD cookie_ = 0;

CComPtr<IWebBrowser2> web_browser_;

CComPtr<IConnectionPoint> connect_point_;

delegate* helper_;

bool m_bNavigationError = false;

};

OnDocumentComplete
1. 网页加载完成就会触发，不管是正常显示还是显示错误页面，都会触发

调试

该工具可以在网页展示后，进行调试
1. 比如在console窗口调用window.external.sys_scan触发某个已注册函数

1	c:\Windows\system32\f12\IEChooser.exe

WebBrowser
概述
框架
MFC 中使用
ATL 中使用
原生 Win32中使用
注意事项
IWebBrowser2
概述
使用方法
CWebBrowserHost
CJsExternal
CWebBrowserEventSink
调试

active-x atl ie iwebbrowser2 mfc web_browser win32

声明：本文为原创文章，版权归Aet所有，欢迎分享本文，转载请保留出处！

Bingliaolong 关注：0 粉丝：0 最后编辑于：2026-03-22

Everything will be better.

`WebBrowser`

概述

框架

`MFC` 中使用

`ATL` 中使用

原生 `Win32`中使用

注意事项

`IWebBrowser2`

概述

使用方法

`CWebBrowserHost`

`CJsExternal`

`CWebBrowserEventSink`

调试

你可能也喜欢

热评文章

发表评论

标签云集

2026 年 4 月
一	二	三	四	五	六	日
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30	31

窗口嵌入网页：WebBrowser简述

WebBrowser

概述

框架

MFC 中使用

ATL 中使用

原生 Win32中使用

注意事项

IWebBrowser2

概述

使用方法

CWebBrowserHost

CJsExternal

CWebBrowserEventSink

调试

你可能也喜欢

热评文章

发表评论

标签云集

`WebBrowser`

`MFC` 中使用

`ATL` 中使用

原生 `Win32`中使用

`IWebBrowser2`

`CWebBrowserHost`

`CJsExternal`

`CWebBrowserEventSink`