ActiveX 控件開發實戰指南：方法接口、事件接口與多線程回調陷阱

在一個「電子地圖 + 視頻監控」項目中，受限於現有 C# 團隊與 C++ 底層框架，選擇 .NET 宿主 ActiveX 控件作為橋接方案。本文梳理 ActiveX 開發的核心脈絡、兩大接口模式、多線程事件回調坑點，並附贈調試工具與代碼備忘錄。

核心概念：COM 與 ActiveX

ActiveX 本質是基於 COM 的控件規範，通過 IUnknown、IDispatch 實現跨語言調用。理解 COM 的「介面契約、引用計數、聚合/包含」是閱讀 MFC/ATL 向導生成代碼的前提。推薦精讀潘愛民《COM 本質論》。

兩大接口模式

1. 方法接口（同步/異步）

• 同步方法：調用 → 阻塞等待 → 返回結果。缺點：JS 單線程模型下會凍結頁面，用戶體驗極差。
• 異步方法：立即返回，啟動後台線程執行耗時任務。難點：如何將結果通知前端？

2. 事件接口（回調機制）

前端（JS）註冊事件監聽器，ActiveX 後台任務完成後觸發事件，前端在事件處理函數中獲取結果。這類似於經典的回調函數模式。

參考閱讀：阮一峰《Javascript 異步編程的 4 種方法》

多線程事件觸發的巨坑

若在後台工作線程中直接 Fire_Event()，前端無法收到事件。原因在於 COM 的單元模型：事件連接點要求在創建該連接點的線程（通常是 UI 主線程/STA 線程）中觸發。

解決方案

1. 工作線程完成任務後，通過 PostMessage 向主線程窗口發送自定義消息。
2. 主線程消息處理函數中調用 Fire_Event()。
3. 參考微軟 KB 文檔：How to start a second thread in an MFC-based ActiveX control to fire events in Visual C++。

開發備忘錄

1. 添加方法/事件介面（MFC 向導）

若提示找不到事件介面，手動在對應 .h/.cpp 中補全聲明與實現。

2. 兩大調試神器

• TstCon32.exe：微軟官方 ActiveX 測試容器，支持屬性/方法/事件完整驗證。
• Microsoft ActiveX Control Pad：可視化編輯屬性頁、生成 HTML 測試頁。

3. JS 調用代碼範例

// 同步調用
var ret = obj.SyncMethod(param);

// 異步調用 + 事件註冊
obj.AsyncMethod(param);
obj.attachEvent("OnResult", function(result) {
    console.log("異步結果:", result);
});

簽名與打包（略）

Authenticode 簽名、CAB 打包、.inf 安裝腳本編寫屬前端部署範疇，網上資源豐富，此處不贅述。

總結

• ActiveX 適合「重客戶端、需調用本地 C++ 庫」的遷移場景。
• 異步方法 + 事件接口是避免頁面凍結的標準範式。
• 多線程觸發事件必須切回 STA 主線程，否則事件丟失無聲無息。
• 善用 TstCon32 進行單元測試，提前暴露 COM 介面問題。