萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML 腳本教學

COM 程式設計:從 IHTMLDocument2 取得 IWebBrowser2 — IServiceProvider 核心機制詳解

問題背景

在 Active Accessibility / COM 自動化中,已取得視窗句柄 → IHTMLDocument2,欲進一步取得 IWebBrowser2 控制瀏覽器行為。直接 QueryInterface 失敗,IHTMLWindow2::get_navigator 也無法取得 IOmNavigator。

核心關鍵:IServiceProvider

COM 規則:QueryInterface 僅詢問「你自己實作哪些介面」。文件、瀏覽器、視窗是**獨立物件**,文件不實作 IWebBrowser2。需透過 IServiceProvider 導航物件層級:

QueryInterface 問:「你實作這介面嗎?」
QueryService 問:「不管哪個物件實作,幫我找到它。」

標準取得流程(ATL 智慧指標)

// 1. 從文件取得 IServiceProvider
CComQIPtr<IServiceProvider> sp = pIHTMLDocument2;

// 2. 透過服務導航取得瀏覽器應用程式介面
CComQIPtr<IWebBrowser2> wb2;
sp->QueryService(SID_SWebBrowserApp, IID_IWebBrowser2, (void**)&wb2);
// 或
sp->QueryService(IID_IWebBrowserApp, IID_IWebBrowser2, (void**)&wb2);

SID_SWebBrowserApp 定義為 IID_IWebBrowserApp,兩者可互換,但用 SID 較符合語意。

完整物件導航鏈

// 從 ActiveX 控制項站點開始
CComQIPtr<IServiceProvider> sp = pSite;           // IOleClientSite → IServiceProvider
CComQIPtr<IWebBrowserApp> wba;
sp->QueryService(SID_SWebBrowserApp, IID_IWebBrowserApp, (void**)&wba); // 應用程式層(最上層)

CComQIPtr<IWebBrowser2> wb2;
sp->QueryService(SID_SWebBrowserApp, IID_IWebBrowser2, (void**)&wb2);   // 瀏覽器控制介面

架構圖解

+----------------+     IServiceProvider      +------------------+
|  Document      | ───────────────────────→ |  WebBrowser2     |
|  (IHTMLDoc2)   |   QueryService(SID, IID)  |  (實作介面)       |
+----------------+                          +------------------+
       ↑                                             ↑
       | 內部指標                                    | 同一或不同物件
       |                                             |
+----------------+                          +------------------+
|  Window        |                          |  Frame/Shell     |
|  (IHTMLWin2)   |                          |  (容器)           |
+----------------+                          +------------------+

實作 IServiceProvider 的關鍵

  • 所有相關 COM 物件(Document, Window, Frame, Browser)皆實作 IServiceProvider
  • 內部持有指向其他物件的指標
  • QueryService 遞歸追蹤內部指標,找到實作目標介面的物件並返回

常見服務識別碼 (SID)

開發建議

  • 優先使用 IServiceProvider::QueryService 導航 DHTML 物件模型
  • 若自行實作大型 COM 物件系統,務必實作 IServiceProvider 以利整合
  • 深入細節請參考 MSDN「DHTML Object Model」與「IServiceProvider」文件
copyright © 萬盛學電腦網 all rights reserved
SID對應介面用途
SID_SWebBrowserAppIWebBrowserApp / IWebBrowser2瀏覽器應用程式/控制介面
SID_SContainerDispatchIDispatch容器自動化介面
IID_IHTMLDocument2IHTMLDocument2文件介面(也可作 SID)