在 IE 瀏覽器中嵌入 ActiveX/OCX 控件(如簽名板、掃描儀、加密鎖),JS 需捕獲控件觸發的自定義事件(如 OnChange、OnScanComplete)並執行業務邏輯。
// .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);
}
<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>
<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 僅 IE 支持,已被微軟棄用。現代瀏覽器請使用:
WebUSB、WebHID、Web Serial API 直接訪問硬件設備。<meta http-equiv="X-UA-Compatible" content="IE=EmulateIE10">。<script for="..." event="..."> 塊,不要混在普通腳本中。try/catch 包裹事件處理器,防止控件異常導致頁面腳本中斷。JS 響應 OCX 事件的核心是 <script for="控件ID" event="事件名(參數)"> 聲明式綁定。雖然技術已過時,但在老舊銀行、政企、醫療系統維護中仍常見。新項目請堅決採用 Web 標準技術棧替代。