萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 實現 OCX 控件事件響應的完整流程

背景

在 IE 瀏覽器中嵌入 ActiveX/OCX 控件(如簽名板、掃描儀、加密鎖),JS 需捕獲控件觸發的自定義事件(如 OnChange、OnScanComplete)並執行業務邏輯。

完整實現步驟

1. OCX 控件端(C++/ATL/MFC/VC++)定義事件

// .idl 或事件映射宏
// 事件映射表
BEGIN_EVENT_MAP(CH_OcxCtrl, COleControl)
  EVENT_CUSTOM_ID("OnChange", eventidChange, OnChange, VTS_NONE)
  // 帶參數事件:VTS_BSTR VTS_I4 等
  EVENT_CUSTOM_ID("OnDataReady", eventidDataReady, OnDataReady, VTS_BSTR VTS_I4)
END_EVENT_MAP()

// 觸發事件(在控件內部適當位置調用)
void CH_OcxCtrl::FireOnChange() {
  FireEvent(eventidChange, EVENT_PARAM(VTS_NONE));
}
void CH_OcxCtrl::FireOnDataReady(LPCTSTR data, long len) {
  FireEvent(eventidDataReady, EVENT_PARAM(VTS_BSTR VTS_I4), data, len);
}

2. HTML 頁面嵌入控件

<object id="MyCtrl" classid="clsid:YOUR-CLSID-HERE" width="0" height="0">
  <param name="_Version" value="65536" />
  <param name="_ExtentX" value="2646" />
  <param name="_ExtentY" value="1323" />
  <param name="_StockProps" value="0" />
</object>

3. JS 捕獲事件(核心語法)

<script language="javascript" for="MyCtrl" event="OnChange()">
  // 此處代碼在控件觸發 OnChange 時自動執行
  handleChange();
</script>

<script language="javascript" for="MyCtrl" event="OnDataReady(data, len)">
  // 帶參數事件:參數名需與控件定義一致(或按順序)
  handleDataReady(data, len);
</script>

<script>
function handleChange() {
  console.log('控件觸發 OnChange');
  // 業務邏輯:刷新界面、發送 AJAX 等
}

function handleDataReady(data, len) {
  console.log('接收數據:', data, '長度:', len);
  document.getElementById('output').value = data;
}
</script>

關鍵點總結

項目要求
for 屬性等於 <object> 的 id(或 name)
event 屬性格式:"EventName()" 或 "EventName(param1,param2)",名稱**必須與控件定義完全一致**
language"javascript" 或 "jscript"
參數傳遞事件定義的參數順序對應 JS 函數參數,JS 直接使用參數名
腳本位置建議放在 <body> 末尾,確保控件已初始化

現代替代方案(無 ActiveX)

ActiveX 僅 IE 支持,已被微軟棄用。現代瀏覽器請使用:

  • WebAssembly:C++/Rust 編譯為 WASM,直接在 JS 中調用,無需插件。
  • Web APIs:WebUSB、WebHID、Web Serial API 直接訪問硬件設備。
  • Native Messaging:瀏覽器擴展與本地宿主程序通信(Chrome/Firefox/Edge 支援)。
  • Electron / Tauri:桌面應用框架,Node.js 原生調用 C++ Addon 或系統 API。

遺留系統維護建議

  1. 頁面強制 IE 模式:<meta http-equiv="X-UA-Compatible" content="IE=EmulateIE10">。
  2. 事件綁定代碼放在單獨 <script for="..." event="..."> 塊,不要混在普通腳本中。
  3. 參數類型對應:BSTR → JS 字串、VT_I4/VT_UI4 → JS number、VT_BOOL → JS boolean、VT_VARIANT → JS 任意。
  4. 錯誤處理:用 try/catch 包裹事件處理器,防止控件異常導致頁面腳本中斷。

總結

JS 響應 OCX 事件的核心是 <script for="控件ID" event="事件名(參數)"> 聲明式綁定。雖然技術已過時,但在老舊銀行、政企、醫療系統維護中仍常見。新項目請堅決採用 Web 標準技術棧替代。

copyright © 萬盛學電腦網 all rights reserved